agent-inspect 1.3.0 → 1.5.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 (82) hide show
  1. package/CHANGELOG.md +47 -4
  2. package/README.md +59 -37
  3. package/docs/ADAPTERS.md +117 -31
  4. package/docs/API.md +24 -6
  5. package/docs/CLI.md +126 -1
  6. package/docs/DIFF.md +8 -0
  7. package/docs/EXPORTS.md +86 -15
  8. package/docs/GETTING-STARTED.md +48 -2
  9. package/docs/KNOWN-ISSUES.md +6 -0
  10. package/docs/LIMITATIONS.md +11 -3
  11. package/docs/LOGS.md +22 -0
  12. package/docs/SCHEMA.md +8 -5
  13. package/docs/SCREENSHOTS.md +190 -9
  14. package/package.json +51 -1
  15. package/packages/cli/dist/index.cjs +3253 -1662
  16. package/packages/cli/dist/index.cjs.map +1 -1
  17. package/packages/cli/dist/index.mjs +3253 -1662
  18. package/packages/cli/dist/index.mjs.map +1 -1
  19. package/packages/core/dist/advanced.cjs +1437 -0
  20. package/packages/core/dist/advanced.cjs.map +1 -0
  21. package/packages/core/dist/advanced.d.cts +159 -0
  22. package/packages/core/dist/advanced.d.ts +159 -0
  23. package/packages/core/dist/advanced.mjs +8 -0
  24. package/packages/core/dist/advanced.mjs.map +1 -0
  25. package/packages/core/dist/chunk-5EMIZZXD.mjs +907 -0
  26. package/packages/core/dist/chunk-5EMIZZXD.mjs.map +1 -0
  27. package/packages/core/dist/chunk-7TGZLWEE.mjs +35 -0
  28. package/packages/core/dist/chunk-7TGZLWEE.mjs.map +1 -0
  29. package/packages/core/dist/chunk-BT7CATSD.mjs +497 -0
  30. package/packages/core/dist/chunk-BT7CATSD.mjs.map +1 -0
  31. package/packages/core/dist/chunk-E5F2LQCX.mjs +83 -0
  32. package/packages/core/dist/chunk-E5F2LQCX.mjs.map +1 -0
  33. package/packages/core/dist/chunk-EDTQHZPM.mjs +88 -0
  34. package/packages/core/dist/chunk-EDTQHZPM.mjs.map +1 -0
  35. package/packages/core/dist/chunk-HY7H3CQM.mjs +127 -0
  36. package/packages/core/dist/chunk-HY7H3CQM.mjs.map +1 -0
  37. package/packages/core/dist/chunk-Q6EPNB3V.mjs +539 -0
  38. package/packages/core/dist/chunk-Q6EPNB3V.mjs.map +1 -0
  39. package/packages/core/dist/chunk-QPAU2TPA.mjs +785 -0
  40. package/packages/core/dist/chunk-QPAU2TPA.mjs.map +1 -0
  41. package/packages/core/dist/chunk-QX3ZMPUF.mjs +451 -0
  42. package/packages/core/dist/chunk-QX3ZMPUF.mjs.map +1 -0
  43. package/packages/core/dist/chunk-VU6O5QAH.mjs +99 -0
  44. package/packages/core/dist/chunk-VU6O5QAH.mjs.map +1 -0
  45. package/packages/core/dist/chunk-XDBND27A.mjs +975 -0
  46. package/packages/core/dist/chunk-XDBND27A.mjs.map +1 -0
  47. package/packages/core/dist/chunk-YWAOOXLR.mjs +475 -0
  48. package/packages/core/dist/chunk-YWAOOXLR.mjs.map +1 -0
  49. package/packages/core/dist/diff.cjs +993 -0
  50. package/packages/core/dist/diff.cjs.map +1 -0
  51. package/packages/core/dist/diff.d.cts +81 -0
  52. package/packages/core/dist/diff.d.ts +81 -0
  53. package/packages/core/dist/diff.mjs +5 -0
  54. package/packages/core/dist/diff.mjs.map +1 -0
  55. package/packages/core/dist/exporters.cjs +1228 -0
  56. package/packages/core/dist/exporters.cjs.map +1 -0
  57. package/packages/core/dist/exporters.d.cts +113 -0
  58. package/packages/core/dist/exporters.d.ts +113 -0
  59. package/packages/core/dist/exporters.mjs +6 -0
  60. package/packages/core/dist/exporters.mjs.map +1 -0
  61. package/packages/core/dist/index.cjs +2982 -1829
  62. package/packages/core/dist/index.cjs.map +1 -1
  63. package/packages/core/dist/index.d.cts +201 -892
  64. package/packages/core/dist/index.d.ts +201 -892
  65. package/packages/core/dist/index.mjs +780 -4620
  66. package/packages/core/dist/index.mjs.map +1 -1
  67. package/packages/core/dist/log-config-BzGmDYum.d.cts +71 -0
  68. package/packages/core/dist/log-config-BzGmDYum.d.ts +71 -0
  69. package/packages/core/dist/logs.cjs +1007 -0
  70. package/packages/core/dist/logs.cjs.map +1 -0
  71. package/packages/core/dist/logs.d.cts +137 -0
  72. package/packages/core/dist/logs.d.ts +137 -0
  73. package/packages/core/dist/logs.mjs +6 -0
  74. package/packages/core/dist/logs.mjs.map +1 -0
  75. package/packages/core/dist/persisted.cjs +1057 -0
  76. package/packages/core/dist/persisted.cjs.map +1 -0
  77. package/packages/core/dist/persisted.d.cts +160 -0
  78. package/packages/core/dist/persisted.d.ts +160 -0
  79. package/packages/core/dist/persisted.mjs +5 -0
  80. package/packages/core/dist/persisted.mjs.map +1 -0
  81. package/packages/core/dist/types-Bkt7LS01.d.ts +226 -0
  82. package/packages/core/dist/types-CNbheSdk.d.cts +226 -0
@@ -0,0 +1,71 @@
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
+ interface LogEventMapping {
42
+ kind?: InspectKind;
43
+ name?: string;
44
+ parent?: string;
45
+ status?: "running" | "ok" | "error";
46
+ startsRun?: boolean;
47
+ endsRun?: boolean;
48
+ startsStep?: boolean;
49
+ endsStep?: boolean;
50
+ }
51
+ type RedactionStrategy = "full" | "prefix" | "hash";
52
+ type RedactionRule = string | {
53
+ key: string;
54
+ strategy: RedactionStrategy;
55
+ keep?: number;
56
+ };
57
+ interface LogIngestConfig {
58
+ runIdKeys: string[];
59
+ eventKey: string;
60
+ timestampKey?: string;
61
+ messageKey?: string;
62
+ levelKey?: string;
63
+ parentIdKey?: string;
64
+ durationKey?: string;
65
+ statusKey?: string;
66
+ mappings?: Record<string, LogEventMapping>;
67
+ redact?: RedactionRule[];
68
+ heuristicWindowMs?: number;
69
+ }
70
+
71
+ export type { AttributionConfidence as A, EventSource as E, InspectEvent as I, LogEventMapping as L, RedactionRule as R, InspectKind as a, InspectNode as b, InspectRunTree as c, LogIngestConfig as d, RedactionStrategy as e };
@@ -0,0 +1,71 @@
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
+ interface LogEventMapping {
42
+ kind?: InspectKind;
43
+ name?: string;
44
+ parent?: string;
45
+ status?: "running" | "ok" | "error";
46
+ startsRun?: boolean;
47
+ endsRun?: boolean;
48
+ startsStep?: boolean;
49
+ endsStep?: boolean;
50
+ }
51
+ type RedactionStrategy = "full" | "prefix" | "hash";
52
+ type RedactionRule = string | {
53
+ key: string;
54
+ strategy: RedactionStrategy;
55
+ keep?: number;
56
+ };
57
+ interface LogIngestConfig {
58
+ runIdKeys: string[];
59
+ eventKey: string;
60
+ timestampKey?: string;
61
+ messageKey?: string;
62
+ levelKey?: string;
63
+ parentIdKey?: string;
64
+ durationKey?: string;
65
+ statusKey?: string;
66
+ mappings?: Record<string, LogEventMapping>;
67
+ redact?: RedactionRule[];
68
+ heuristicWindowMs?: number;
69
+ }
70
+
71
+ export type { AttributionConfidence as A, EventSource as E, InspectEvent as I, LogEventMapping as L, RedactionRule as R, InspectKind as a, InspectNode as b, InspectRunTree as c, LogIngestConfig as d, RedactionStrategy as e };