agent-inspect 1.4.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/CHANGELOG.md +63 -0
  2. package/README.md +34 -6
  3. package/docs/ADAPTERS.md +6 -0
  4. package/docs/API.md +132 -9
  5. package/docs/ARCHITECTURE.md +4 -0
  6. package/docs/CLI.md +98 -5
  7. package/docs/DIFF.md +8 -0
  8. package/docs/EXPORTS.md +13 -0
  9. package/docs/GETTING-STARTED.md +19 -1
  10. package/docs/KNOWN-ISSUES.md +8 -1
  11. package/docs/LIMITATIONS.md +13 -2
  12. package/docs/LOGS.md +22 -0
  13. package/docs/SCHEMA.md +19 -7
  14. package/docs/SCREENSHOTS.md +190 -9
  15. package/package.json +71 -1
  16. package/packages/cli/dist/index.cjs +7121 -3986
  17. package/packages/cli/dist/index.cjs.map +1 -1
  18. package/packages/cli/dist/index.mjs +7122 -3987
  19. package/packages/cli/dist/index.mjs.map +1 -1
  20. package/packages/core/dist/advanced.cjs +2258 -0
  21. package/packages/core/dist/advanced.cjs.map +1 -0
  22. package/packages/core/dist/advanced.d.cts +254 -0
  23. package/packages/core/dist/advanced.d.ts +254 -0
  24. package/packages/core/dist/advanced.mjs +11 -0
  25. package/packages/core/dist/advanced.mjs.map +1 -0
  26. package/packages/core/dist/chunk-57S5D6HR.mjs +655 -0
  27. package/packages/core/dist/chunk-57S5D6HR.mjs.map +1 -0
  28. package/packages/core/dist/chunk-6QSLZCBJ.mjs +743 -0
  29. package/packages/core/dist/chunk-6QSLZCBJ.mjs.map +1 -0
  30. package/packages/core/dist/chunk-6SZPTECC.mjs +342 -0
  31. package/packages/core/dist/chunk-6SZPTECC.mjs.map +1 -0
  32. package/packages/core/dist/chunk-74XZ6N7Q.mjs +409 -0
  33. package/packages/core/dist/chunk-74XZ6N7Q.mjs.map +1 -0
  34. package/packages/core/dist/chunk-7TGZLWEE.mjs +35 -0
  35. package/packages/core/dist/chunk-7TGZLWEE.mjs.map +1 -0
  36. package/packages/core/dist/chunk-BT7CATSD.mjs +497 -0
  37. package/packages/core/dist/chunk-BT7CATSD.mjs.map +1 -0
  38. package/packages/core/dist/chunk-E5F2LQCX.mjs +83 -0
  39. package/packages/core/dist/chunk-E5F2LQCX.mjs.map +1 -0
  40. package/packages/core/dist/chunk-EDTQHZPM.mjs +88 -0
  41. package/packages/core/dist/chunk-EDTQHZPM.mjs.map +1 -0
  42. package/packages/core/dist/chunk-HR7G62IE.mjs +785 -0
  43. package/packages/core/dist/chunk-HR7G62IE.mjs.map +1 -0
  44. package/packages/core/dist/chunk-HY7H3CQM.mjs +127 -0
  45. package/packages/core/dist/chunk-HY7H3CQM.mjs.map +1 -0
  46. package/packages/core/dist/chunk-S4YWKV4G.mjs +48 -0
  47. package/packages/core/dist/chunk-S4YWKV4G.mjs.map +1 -0
  48. package/packages/core/dist/chunk-TFLPUZ56.mjs +1571 -0
  49. package/packages/core/dist/chunk-TFLPUZ56.mjs.map +1 -0
  50. package/packages/core/dist/chunk-TZISEVLQ.mjs +390 -0
  51. package/packages/core/dist/chunk-TZISEVLQ.mjs.map +1 -0
  52. package/packages/core/dist/chunk-U2BGPESY.mjs +150 -0
  53. package/packages/core/dist/chunk-U2BGPESY.mjs.map +1 -0
  54. package/packages/core/dist/chunk-VTIB5MDK.mjs +304 -0
  55. package/packages/core/dist/chunk-VTIB5MDK.mjs.map +1 -0
  56. package/packages/core/dist/chunk-VU6O5QAH.mjs +99 -0
  57. package/packages/core/dist/chunk-VU6O5QAH.mjs.map +1 -0
  58. package/packages/core/dist/chunk-Y56BPA3B.mjs +990 -0
  59. package/packages/core/dist/chunk-Y56BPA3B.mjs.map +1 -0
  60. package/packages/core/dist/chunk-YWAOOXLR.mjs +475 -0
  61. package/packages/core/dist/chunk-YWAOOXLR.mjs.map +1 -0
  62. package/packages/core/dist/diff.cjs +993 -0
  63. package/packages/core/dist/diff.cjs.map +1 -0
  64. package/packages/core/dist/diff.d.cts +82 -0
  65. package/packages/core/dist/diff.d.ts +82 -0
  66. package/packages/core/dist/diff.mjs +5 -0
  67. package/packages/core/dist/diff.mjs.map +1 -0
  68. package/packages/core/dist/exporters.cjs +1228 -0
  69. package/packages/core/dist/exporters.cjs.map +1 -0
  70. package/packages/core/dist/exporters.d.cts +114 -0
  71. package/packages/core/dist/exporters.d.ts +114 -0
  72. package/packages/core/dist/exporters.mjs +6 -0
  73. package/packages/core/dist/exporters.mjs.map +1 -0
  74. package/packages/core/dist/index.cjs +5542 -2218
  75. package/packages/core/dist/index.cjs.map +1 -1
  76. package/packages/core/dist/index.d.cts +113 -908
  77. package/packages/core/dist/index.d.ts +113 -908
  78. package/packages/core/dist/index.mjs +1048 -5403
  79. package/packages/core/dist/index.mjs.map +1 -1
  80. package/packages/core/dist/inspect-event-Des4JDHo.d.cts +41 -0
  81. package/packages/core/dist/inspect-event-Des4JDHo.d.ts +41 -0
  82. package/packages/core/dist/log-config-BnH8Ykcb.d.cts +33 -0
  83. package/packages/core/dist/log-config-C1GcJPIM.d.ts +33 -0
  84. package/packages/core/dist/logs.cjs +1007 -0
  85. package/packages/core/dist/logs.cjs.map +1 -0
  86. package/packages/core/dist/logs.d.cts +138 -0
  87. package/packages/core/dist/logs.d.ts +138 -0
  88. package/packages/core/dist/logs.mjs +6 -0
  89. package/packages/core/dist/logs.mjs.map +1 -0
  90. package/packages/core/dist/persisted-inspect-event-0kaRADsp.d.cts +56 -0
  91. package/packages/core/dist/persisted-inspect-event-DiFto0K2.d.ts +56 -0
  92. package/packages/core/dist/persisted.cjs +1055 -0
  93. package/packages/core/dist/persisted.cjs.map +1 -0
  94. package/packages/core/dist/persisted.d.cts +111 -0
  95. package/packages/core/dist/persisted.d.ts +111 -0
  96. package/packages/core/dist/persisted.mjs +7 -0
  97. package/packages/core/dist/persisted.mjs.map +1 -0
  98. package/packages/core/dist/readers.cjs +2590 -0
  99. package/packages/core/dist/readers.cjs.map +1 -0
  100. package/packages/core/dist/readers.d.cts +80 -0
  101. package/packages/core/dist/readers.d.ts +80 -0
  102. package/packages/core/dist/readers.mjs +9 -0
  103. package/packages/core/dist/readers.mjs.map +1 -0
  104. package/packages/core/dist/types-DB8jB6Jg.d.cts +232 -0
  105. package/packages/core/dist/types-tSix7tfv.d.ts +232 -0
  106. package/packages/core/dist/writers.cjs +997 -0
  107. package/packages/core/dist/writers.cjs.map +1 -0
  108. package/packages/core/dist/writers.d.cts +62 -0
  109. package/packages/core/dist/writers.d.ts +62 -0
  110. package/packages/core/dist/writers.mjs +9 -0
  111. package/packages/core/dist/writers.mjs.map +1 -0
@@ -0,0 +1,41 @@
1
+ type AttributionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
2
+ type InspectKind = "RUN" | "AGENT" | "LLM" | "TOOL" | "CHAIN" | "RETRIEVER" | "DECISION" | "RESULT" | "ERROR" | "LOGIC" | "LOG";
3
+ interface EventSource {
4
+ type: "manual" | "json-log" | "log4js" | "pino" | "winston" | "adapter";
5
+ file?: string;
6
+ line?: number;
7
+ }
8
+ interface InspectEvent {
9
+ eventId: string;
10
+ runId: string;
11
+ parentId?: string;
12
+ name: string;
13
+ kind: InspectKind;
14
+ timestamp: number;
15
+ status?: "running" | "ok" | "error";
16
+ durationMs?: number;
17
+ attributes?: Record<string, unknown>;
18
+ confidence: AttributionConfidence;
19
+ source: EventSource;
20
+ }
21
+ interface InspectNode {
22
+ event: InspectEvent;
23
+ children: InspectNode[];
24
+ depth: number;
25
+ }
26
+ interface InspectRunTree {
27
+ runId: string;
28
+ name?: string;
29
+ status?: "running" | "ok" | "error";
30
+ startedAt?: number;
31
+ endedAt?: number;
32
+ durationMs?: number;
33
+ children: InspectNode[];
34
+ metadata: {
35
+ totalEvents: number;
36
+ confidenceBreakdown: Record<AttributionConfidence, number>;
37
+ kinds: Record<InspectKind, number>;
38
+ };
39
+ }
40
+
41
+ export type { AttributionConfidence as A, EventSource as E, InspectKind as I, InspectEvent as a, InspectNode as b, InspectRunTree as c };
@@ -0,0 +1,41 @@
1
+ type AttributionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
2
+ type InspectKind = "RUN" | "AGENT" | "LLM" | "TOOL" | "CHAIN" | "RETRIEVER" | "DECISION" | "RESULT" | "ERROR" | "LOGIC" | "LOG";
3
+ interface EventSource {
4
+ type: "manual" | "json-log" | "log4js" | "pino" | "winston" | "adapter";
5
+ file?: string;
6
+ line?: number;
7
+ }
8
+ interface InspectEvent {
9
+ eventId: string;
10
+ runId: string;
11
+ parentId?: string;
12
+ name: string;
13
+ kind: InspectKind;
14
+ timestamp: number;
15
+ status?: "running" | "ok" | "error";
16
+ durationMs?: number;
17
+ attributes?: Record<string, unknown>;
18
+ confidence: AttributionConfidence;
19
+ source: EventSource;
20
+ }
21
+ interface InspectNode {
22
+ event: InspectEvent;
23
+ children: InspectNode[];
24
+ depth: number;
25
+ }
26
+ interface InspectRunTree {
27
+ runId: string;
28
+ name?: string;
29
+ status?: "running" | "ok" | "error";
30
+ startedAt?: number;
31
+ endedAt?: number;
32
+ durationMs?: number;
33
+ children: InspectNode[];
34
+ metadata: {
35
+ totalEvents: number;
36
+ confidenceBreakdown: Record<AttributionConfidence, number>;
37
+ kinds: Record<InspectKind, number>;
38
+ };
39
+ }
40
+
41
+ export type { AttributionConfidence as A, EventSource as E, InspectKind as I, InspectEvent as a, InspectNode as b, InspectRunTree as c };
@@ -0,0 +1,33 @@
1
+ import { I as InspectKind } from './inspect-event-Des4JDHo.cjs';
2
+
3
+ interface LogEventMapping {
4
+ kind?: InspectKind;
5
+ name?: string;
6
+ parent?: string;
7
+ status?: "running" | "ok" | "error";
8
+ startsRun?: boolean;
9
+ endsRun?: boolean;
10
+ startsStep?: boolean;
11
+ endsStep?: boolean;
12
+ }
13
+ type RedactionStrategy = "full" | "prefix" | "hash";
14
+ type RedactionRule = string | {
15
+ key: string;
16
+ strategy: RedactionStrategy;
17
+ keep?: number;
18
+ };
19
+ interface LogIngestConfig {
20
+ runIdKeys: string[];
21
+ eventKey: string;
22
+ timestampKey?: string;
23
+ messageKey?: string;
24
+ levelKey?: string;
25
+ parentIdKey?: string;
26
+ durationKey?: string;
27
+ statusKey?: string;
28
+ mappings?: Record<string, LogEventMapping>;
29
+ redact?: RedactionRule[];
30
+ heuristicWindowMs?: number;
31
+ }
32
+
33
+ export type { LogEventMapping as L, RedactionRule as R, LogIngestConfig as a, RedactionStrategy as b };
@@ -0,0 +1,33 @@
1
+ import { I as InspectKind } from './inspect-event-Des4JDHo.js';
2
+
3
+ interface LogEventMapping {
4
+ kind?: InspectKind;
5
+ name?: string;
6
+ parent?: string;
7
+ status?: "running" | "ok" | "error";
8
+ startsRun?: boolean;
9
+ endsRun?: boolean;
10
+ startsStep?: boolean;
11
+ endsStep?: boolean;
12
+ }
13
+ type RedactionStrategy = "full" | "prefix" | "hash";
14
+ type RedactionRule = string | {
15
+ key: string;
16
+ strategy: RedactionStrategy;
17
+ keep?: number;
18
+ };
19
+ interface LogIngestConfig {
20
+ runIdKeys: string[];
21
+ eventKey: string;
22
+ timestampKey?: string;
23
+ messageKey?: string;
24
+ levelKey?: string;
25
+ parentIdKey?: string;
26
+ durationKey?: string;
27
+ statusKey?: string;
28
+ mappings?: Record<string, LogEventMapping>;
29
+ redact?: RedactionRule[];
30
+ heuristicWindowMs?: number;
31
+ }
32
+
33
+ export type { LogEventMapping as L, RedactionRule as R, LogIngestConfig as a, RedactionStrategy as b };