agent-rulebook 0.2.1 → 0.3.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 (177) hide show
  1. package/README.md +46 -4
  2. package/dist/commands/dashboard.d.ts +7 -0
  3. package/dist/commands/dashboard.js +42 -0
  4. package/dist/commands/dashboard.js.map +1 -0
  5. package/dist/commands/diagnostics.d.ts +2 -0
  6. package/dist/commands/diagnostics.js +38 -0
  7. package/dist/commands/diagnostics.js.map +1 -0
  8. package/dist/commands/import.d.ts +2 -0
  9. package/dist/commands/import.js +34 -0
  10. package/dist/commands/import.js.map +1 -0
  11. package/dist/commands/pending.d.ts +2 -0
  12. package/dist/commands/pending.js +27 -0
  13. package/dist/commands/pending.js.map +1 -0
  14. package/dist/commands/resolution.js +25 -11
  15. package/dist/commands/resolution.js.map +1 -1
  16. package/dist/commands/stats-renderer.d.ts +3 -0
  17. package/dist/commands/stats-renderer.js +76 -0
  18. package/dist/commands/stats-renderer.js.map +1 -0
  19. package/dist/commands/stats.d.ts +4 -0
  20. package/dist/commands/stats.js +107 -0
  21. package/dist/commands/stats.js.map +1 -0
  22. package/dist/commands/status.d.ts +2 -0
  23. package/dist/commands/status.js +17 -0
  24. package/dist/commands/status.js.map +1 -0
  25. package/dist/commands/sync.js +1 -1
  26. package/dist/commands/sync.js.map +1 -1
  27. package/dist/commands/usage.d.ts +2 -0
  28. package/dist/commands/usage.js +25 -0
  29. package/dist/commands/usage.js.map +1 -0
  30. package/dist/core/codex-call-parser.d.ts +10 -0
  31. package/dist/core/codex-call-parser.js +97 -0
  32. package/dist/core/codex-call-parser.js.map +1 -0
  33. package/dist/core/codex-usage-import.d.ts +24 -0
  34. package/dist/core/codex-usage-import.js +259 -0
  35. package/dist/core/codex-usage-import.js.map +1 -0
  36. package/dist/core/diagnostic-cluster.d.ts +37 -0
  37. package/dist/core/diagnostic-cluster.js +20 -0
  38. package/dist/core/diagnostic-cluster.js.map +1 -0
  39. package/dist/core/environment-normalization.d.ts +21 -0
  40. package/dist/core/environment-normalization.js +42 -0
  41. package/dist/core/environment-normalization.js.map +1 -0
  42. package/dist/core/index.d.ts +1 -0
  43. package/dist/core/index.js +1 -0
  44. package/dist/core/index.js.map +1 -1
  45. package/dist/core/invocation-diagnostics.d.ts +40 -0
  46. package/dist/core/invocation-diagnostics.js +91 -0
  47. package/dist/core/invocation-diagnostics.js.map +1 -0
  48. package/dist/core/legacy-candidate.d.ts +159 -0
  49. package/dist/core/legacy-candidate.js +73 -0
  50. package/dist/core/legacy-candidate.js.map +1 -0
  51. package/dist/core/legacy-import-apply.d.ts +215 -0
  52. package/dist/core/legacy-import-apply.js +172 -0
  53. package/dist/core/legacy-import-apply.js.map +1 -0
  54. package/dist/core/legacy-import-manifest.d.ts +197 -0
  55. package/dist/core/legacy-import-manifest.js +63 -0
  56. package/dist/core/legacy-import-manifest.js.map +1 -0
  57. package/dist/core/legacy-scan.d.ts +71 -0
  58. package/dist/core/legacy-scan.js +99 -0
  59. package/dist/core/legacy-scan.js.map +1 -0
  60. package/dist/core/pending-replay.d.ts +4 -0
  61. package/dist/core/pending-replay.js +96 -0
  62. package/dist/core/pending-replay.js.map +1 -0
  63. package/dist/core/resolution-applicability.d.ts +1 -0
  64. package/dist/core/resolution-applicability.js +28 -11
  65. package/dist/core/resolution-applicability.js.map +1 -1
  66. package/dist/core/resolution-ranker.js +9 -2
  67. package/dist/core/resolution-ranker.js.map +1 -1
  68. package/dist/core/resolution-search-types.d.ts +9 -0
  69. package/dist/core/statistics-data.d.ts +98 -0
  70. package/dist/core/statistics-data.js +53 -0
  71. package/dist/core/statistics-data.js.map +1 -0
  72. package/dist/core/statistics-pages.d.ts +3 -0
  73. package/dist/core/statistics-pages.js +107 -0
  74. package/dist/core/statistics-pages.js.map +1 -0
  75. package/dist/core/statistics-query.d.ts +86 -0
  76. package/dist/core/statistics-query.js +51 -0
  77. package/dist/core/statistics-query.js.map +1 -0
  78. package/dist/core/statistics-types.d.ts +286 -0
  79. package/dist/core/statistics-types.js +2 -0
  80. package/dist/core/statistics-types.js.map +1 -0
  81. package/dist/core/statistics.d.ts +5 -0
  82. package/dist/core/statistics.js +101 -0
  83. package/dist/core/statistics.js.map +1 -0
  84. package/dist/core/sync-status.d.ts +53 -0
  85. package/dist/core/sync-status.js +85 -0
  86. package/dist/core/sync-status.js.map +1 -0
  87. package/dist/core/usage-context.d.ts +15 -0
  88. package/dist/core/usage-context.js +22 -0
  89. package/dist/core/usage-context.js.map +1 -0
  90. package/dist/core/usage-observer.d.ts +36 -0
  91. package/dist/core/usage-observer.js +112 -0
  92. package/dist/core/usage-observer.js.map +1 -0
  93. package/dist/core/usage-schema.d.ts +113 -0
  94. package/dist/core/usage-schema.js +33 -0
  95. package/dist/core/usage-schema.js.map +1 -0
  96. package/dist/dashboard/public/api.js +41 -0
  97. package/dist/dashboard/public/app.js +111 -0
  98. package/dist/dashboard/public/components/detail-panel.js +21 -0
  99. package/dist/dashboard/public/components/index.js +216 -0
  100. package/dist/dashboard/public/components/input-diff.js +15 -0
  101. package/dist/dashboard/public/diagnostic-detail.js +25 -0
  102. package/dist/dashboard/public/diagnostics.js +46 -0
  103. package/dist/dashboard/public/index.html +28 -0
  104. package/dist/dashboard/public/knowledge.js +57 -0
  105. package/dist/dashboard/public/overview.js +101 -0
  106. package/dist/dashboard/public/solution-detail.js +42 -0
  107. package/dist/dashboard/public/styles.css +205 -0
  108. package/dist/dashboard/server.d.ts +10 -0
  109. package/dist/dashboard/server.js +133 -0
  110. package/dist/dashboard/server.js.map +1 -0
  111. package/dist/index.d.ts +4 -0
  112. package/dist/index.js +3 -0
  113. package/dist/index.js.map +1 -1
  114. package/dist/mcp/observed-transport.d.ts +20 -0
  115. package/dist/mcp/observed-transport.js +99 -0
  116. package/dist/mcp/observed-transport.js.map +1 -0
  117. package/dist/mcp/resolution-change.d.ts +1 -1
  118. package/dist/mcp/resolution-change.js +24 -9
  119. package/dist/mcp/resolution-change.js.map +1 -1
  120. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  121. package/dist/mcp/resolutions-commit-change-tool.js +22 -4
  122. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -1
  123. package/dist/mcp/resolutions-find-tool.d.ts +1 -2
  124. package/dist/mcp/resolutions-find-tool.js +43 -8
  125. package/dist/mcp/resolutions-find-tool.js.map +1 -1
  126. package/dist/mcp/resolutions-list-facets-tool.d.ts +1 -1
  127. package/dist/mcp/resolutions-list-facets-tool.js +16 -2
  128. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -1
  129. package/dist/mcp/resolutions-report-attempt-tool.d.ts +1 -0
  130. package/dist/mcp/resolutions-report-attempt-tool.js +44 -55
  131. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -1
  132. package/dist/mcp/schemas.d.ts +299 -14
  133. package/dist/mcp/schemas.js +31 -10
  134. package/dist/mcp/schemas.js.map +1 -1
  135. package/dist/mcp/server.js +20 -5
  136. package/dist/mcp/server.js.map +1 -1
  137. package/dist/mcp/stats-get-tool.d.ts +99 -0
  138. package/dist/mcp/stats-get-tool.js +17 -0
  139. package/dist/mcp/stats-get-tool.js.map +1 -0
  140. package/dist/mcp/tool-call.d.ts +99 -0
  141. package/dist/mcp/tool-call.js +20 -0
  142. package/dist/mcp/tool-call.js.map +1 -0
  143. package/dist/mcp/tool-output.d.ts +9 -0
  144. package/dist/mcp/tool-output.js +22 -0
  145. package/dist/mcp/tool-output.js.map +1 -1
  146. package/dist/mcp/tools.d.ts +182 -27
  147. package/dist/mcp/tools.js +9 -2
  148. package/dist/mcp/tools.js.map +1 -1
  149. package/dist/program.js +14 -0
  150. package/dist/program.js.map +1 -1
  151. package/dist/storage/canonical-write-lock.d.ts +2 -0
  152. package/dist/storage/canonical-write-lock.js +32 -0
  153. package/dist/storage/canonical-write-lock.js.map +1 -0
  154. package/dist/storage/diagnostic-store.d.ts +21 -0
  155. package/dist/storage/diagnostic-store.js +50 -0
  156. package/dist/storage/diagnostic-store.js.map +1 -0
  157. package/dist/storage/import-manifest.d.ts +6 -0
  158. package/dist/storage/import-manifest.js +41 -0
  159. package/dist/storage/import-manifest.js.map +1 -0
  160. package/dist/storage/pending-store.d.ts +329 -0
  161. package/dist/storage/pending-store.js +164 -0
  162. package/dist/storage/pending-store.js.map +1 -0
  163. package/dist/storage/resolution-candidate-service.js +2 -1
  164. package/dist/storage/resolution-candidate-service.js.map +1 -1
  165. package/dist/storage/resolution-change-transaction.d.ts +41 -3
  166. package/dist/storage/resolution-change-transaction.js +101 -12
  167. package/dist/storage/resolution-change-transaction.js.map +1 -1
  168. package/dist/storage/resolution-home.js +1 -1
  169. package/dist/storage/resolution-home.js.map +1 -1
  170. package/dist/storage/resolution-index-check.js +3 -2
  171. package/dist/storage/resolution-index-check.js.map +1 -1
  172. package/dist/storage/resolution-indexer.js +3 -1
  173. package/dist/storage/resolution-indexer.js.map +1 -1
  174. package/dist/storage/usage-store.d.ts +80 -0
  175. package/dist/storage/usage-store.js +239 -0
  176. package/dist/storage/usage-store.js.map +1 -0
  177. package/package.json +11 -4
@@ -0,0 +1,36 @@
1
+ import { type UsageWriteResult } from '../storage/usage-store.js';
2
+ import { type UsageContext } from './usage-context.js';
3
+ import type { DiagnosticIssueInput } from './invocation-diagnostics.js';
4
+ export type ObservedCall = {
5
+ invocationId: string;
6
+ started: number;
7
+ context: UsageContext;
8
+ projectKey: string | null;
9
+ recording: UsageWriteResult['status'];
10
+ diagnosticId: string | null;
11
+ validationRejected: boolean;
12
+ reportedResult?: 'solved' | 'failed' | 'inapplicable' | 'inconclusive' | 'regressed';
13
+ };
14
+ export declare class UsageObserver {
15
+ readonly home: string;
16
+ readonly surface: 'mcp' | 'cli';
17
+ readonly collectorId: `${string}-${string}-${string}-${string}-${string}`;
18
+ client: {
19
+ name?: unknown;
20
+ version?: unknown;
21
+ agent?: unknown;
22
+ model?: unknown;
23
+ };
24
+ constructor(home: string, surface: 'mcp' | 'cli');
25
+ begin(name: unknown, input: unknown, requestId?: unknown, protocolIssues?: DiagnosticIssueInput[]): ObservedCall | undefined;
26
+ complete(call: ObservedCall | undefined, response: unknown, interrupted?: string): {
27
+ invocation_id: string;
28
+ supplied_invocation_id: string | null;
29
+ investigation_id: string | null;
30
+ retry_of: string | null;
31
+ project_key: string | null;
32
+ recording_status: "disabled" | "degraded" | "recorded" | "already_recorded";
33
+ invocation_id_scope: string;
34
+ } | undefined;
35
+ }
36
+ export declare function object(value: unknown): Record<string, unknown>;
@@ -0,0 +1,112 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import { performance } from 'node:perf_hooks';
3
+ import { z } from 'zod';
4
+ import { AGENT_RULEBOOK_MCP_TOOLS } from '../mcp/tools.js';
5
+ import { validateFindRequest } from '../mcp/schemas.js';
6
+ import { inputIssues } from '../mcp/tool-output.js';
7
+ import { AGENT_RULEBOOK_VERSION } from '../version.js';
8
+ import { completeUsageInvocation, guardUsageWrite, recordUsageStart } from '../storage/usage-store.js';
9
+ import { recordInvocationDiagnostic } from '../storage/diagnostic-store.js';
10
+ import { normalizeEnvironmentValue } from './environment-normalization.js';
11
+ import { readUsageContext, safeUsageLabel } from './usage-context.js';
12
+ export class UsageObserver {
13
+ home;
14
+ surface;
15
+ collectorId = randomUUID();
16
+ client = {};
17
+ constructor(home, surface) {
18
+ this.home = home;
19
+ this.surface = surface;
20
+ }
21
+ begin(name, input, requestId, protocolIssues) {
22
+ if (name === 'stats.get')
23
+ return undefined;
24
+ try {
25
+ const tool = AGENT_RULEBOOK_MCP_TOOLS.find((tool) => tool.name === name);
26
+ const context = readUsageContext(input);
27
+ const args = object(input);
28
+ const payload = object(args.payload);
29
+ const problem = object(args.problem ?? payload.problem);
30
+ const suppliedProjects = [context.project_key, args.project_key, object(args.current_evidence).project_key].filter((value) => typeof value === 'string');
31
+ const projectKey = suppliedProjects.length && suppliedProjects.every((value) => /^[a-z0-9][a-z0-9._-]{0,127}$/.test(value) && safeUsageLabel(value) === value && value === suppliedProjects[0]) ? suppliedProjects[0] : null;
32
+ const jsonSchema = tool ? z.toJSONSchema(tool.inputSchema, { io: 'input' }) : { type: 'unknown_tool' };
33
+ const environment = object(args.environment ?? problem.environment);
34
+ const normalized = (key) => [...new Set((Array.isArray(environment[key]) ? environment[key] : []).filter((value) => typeof value === 'string').slice(0, 32).map((value) => normalizeEnvironmentValue(value).family).map((value) => /^[a-z][a-z0-9+#. -]{0,31}$/.test(value) && safeUsageLabel(value) === value && !value.includes(' ') ? value : 'unknown'))];
35
+ const invocationId = randomUUID();
36
+ const started = performance.now();
37
+ const recording = recordUsageStart(this.home, { invocation_id: invocationId, collector_instance_id: this.collectorId, request_id_hash: requestId === undefined ? null : sha(JSON.stringify(requestId)), started_at: new Date().toISOString(), surface: this.surface, tool: tool?.name ?? (name === '<transport>' ? '<transport>' : '<unknown_tool>'), package_version: AGENT_RULEBOOK_VERSION, schema_digest: sha(JSON.stringify(jsonSchema)), client_name: safeUsageLabel(this.client.name), client_version: safeUsageLabel(this.client.version), supplied_agent: context.supplied_agent ?? safeUsageLabel(this.client.agent), supplied_model: context.supplied_model ?? safeUsageLabel(this.client.model), project_key: projectKey, investigation_id: context.investigation_id ?? null, supplied_invocation_id: context.invocation_id ?? null, retry_of: context.retry_of ?? null, languages: normalized('languages'), platforms: normalized('platforms'), runtimes: normalized('runtimes'), tools: normalized('tools'), source: 'live', confidence: 'observed', usage_kind: process.env.AGENT_RULEBOOK_USAGE_KIND === 'test' ? 'test' : 'production' }).status;
38
+ const parsed = tool?.name === 'resolutions.find' ? validateFindRequest(input) : tool?.inputSchema.safeParse(input ?? {});
39
+ const issues = protocolIssues ?? (parsed && !parsed.success ? inputIssues(parsed.error.issues, input) : !tool ? [{ code: 'unknown_tool', path: [], expected: 'object', received: 'unknown' }] : []);
40
+ const diagnosticId = recording === 'recorded' && issues.length ? recordInvocationDiagnostic(this.home, invocationId, input, issues, schemaEnums(jsonSchema)).diagnostic_id : null;
41
+ const reportedResult = ['solved', 'failed', 'inapplicable', 'inconclusive', 'regressed'].includes(String(args.result)) ? args.result : undefined;
42
+ return { invocationId, started, context, projectKey, recording, diagnosticId, validationRejected: Boolean(protocolIssues?.length || parsed && !parsed.success), reportedResult };
43
+ }
44
+ catch (error) {
45
+ guardUsageWrite(this.home, undefined, () => { throw error; });
46
+ return undefined;
47
+ }
48
+ }
49
+ complete(call, response, interrupted) {
50
+ if (!call)
51
+ return undefined;
52
+ const rpc = object(response);
53
+ const result = object(rpc.result ?? response);
54
+ const error = object(rpc.error);
55
+ const content = Array.isArray(result.content) ? object(result.content[0]) : {};
56
+ let body = {};
57
+ try {
58
+ if (typeof content.text === 'string')
59
+ body = object(JSON.parse(content.text));
60
+ }
61
+ catch { /* Non-JSON output has no portable summary. */ }
62
+ const category = interrupted || error.code === -32700 ? 'protocol_error' : call.validationRejected ? 'validation_error' : Object.keys(error).length ? error.code === -32602 ? 'validation_error' : 'protocol_error' : body.code === 'unknown_tool' || body.code === 'tasks_not_supported' ? 'protocol_error' : body.category === 'invalid_input' ? 'validation_error' : body.status === 'no_results' ? 'no_results' : body.status === 'candidates_exhausted' ? 'candidates_exhausted' : result.isError || ['error', 'blocked', 'unavailable', 'not_found', 'pending'].includes(String(body.status)) ? 'domain_error' : 'success';
63
+ let recording = call.recording;
64
+ if (recording === 'recorded')
65
+ recording = completeUsageInvocation(this.home, call.invocationId, { ended_at: new Date().toISOString(), duration_ms: Math.max(0, performance.now() - call.started), status: interrupted ? 'interrupted' : 'completed', category, result_summary: interrupted ? { status: interrupted } : resultSummary(body, call), diagnostic_ref: call.diagnosticId }).status;
66
+ return { invocation_id: call.invocationId, supplied_invocation_id: call.context.invocation_id ?? null, investigation_id: call.context.investigation_id ?? null, retry_of: call.context.retry_of ?? null, project_key: call.projectKey, recording_status: recording, invocation_id_scope: 'server' };
67
+ }
68
+ }
69
+ function resultSummary(body, call) {
70
+ const summary = {};
71
+ if (Array.isArray(body.candidates))
72
+ summary.candidate_count = body.candidates.length;
73
+ if (typeof body.solution_handle === 'string' && /^solution-[a-z0-9-]+@[1-9][0-9]*$/.test(body.solution_handle))
74
+ summary.solution_handle = body.solution_handle;
75
+ if (typeof body.outcome_id === 'string' && /^outcome-[a-z0-9-]+$/.test(body.outcome_id))
76
+ summary.outcome_id = body.outcome_id;
77
+ if (typeof body.relation === 'string' && /^[a-z_]{1,40}$/.test(body.relation))
78
+ summary.relation = body.relation;
79
+ if (typeof body.status === 'string' && /^[a-z_]{1,40}$/.test(body.status))
80
+ summary.status = body.status;
81
+ if (typeof body.canonical_write === 'boolean')
82
+ summary.canonical_write = body.canonical_write;
83
+ if (call.reportedResult)
84
+ summary.result = call.reportedResult;
85
+ const receipt = object(body.receipt);
86
+ if (body.canonical_write === true && Array.isArray(receipt.documents)) {
87
+ const outcomes = receipt.documents.map(object).filter((doc) => doc.kind === 'outcome' && typeof doc.id === 'string' && /^outcome-[a-z0-9-]+$/.test(doc.id));
88
+ if (outcomes.length === 1)
89
+ summary.outcome_id = String(outcomes[0].id);
90
+ const solutions = receipt.documents.map(object).filter((doc) => doc.kind === 'solution' && typeof doc.id === 'string' && /^solution-[a-z0-9-]+$/.test(doc.id) && Number.isSafeInteger(doc.revision));
91
+ summary.created_solution_ids = solutions.filter(({ revision }) => revision === 1).map(({ id }) => String(id)).slice(0, 100);
92
+ summary.created_revisions = solutions.map(({ id, revision }) => `${id}@${revision}`).slice(0, 100);
93
+ }
94
+ return summary;
95
+ }
96
+ function schemaEnums(schema, path = [], result = {}) {
97
+ const node = object(schema);
98
+ if (Array.isArray(node.enum) && node.enum.every((value) => typeof value === 'string'))
99
+ result[path.join('.')] = node.enum;
100
+ for (const [key, value] of Object.entries(object(node.properties)))
101
+ schemaEnums(value, [...path, key], result);
102
+ if (node.items)
103
+ schemaEnums(node.items, [...path, '*'], result);
104
+ for (const key of ['anyOf', 'oneOf', 'allOf'])
105
+ if (Array.isArray(node[key]))
106
+ for (const branch of node[key])
107
+ schemaEnums(branch, path, result);
108
+ return result;
109
+ }
110
+ export function object(value) { return value && typeof value === 'object' && !Array.isArray(value) ? value : {}; }
111
+ function sha(value) { return `sha256:${createHash('sha256').update(value).digest('hex')}`; }
112
+ //# sourceMappingURL=usage-observer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-observer.js","sourceRoot":"","sources":["../../src/core/usage-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,gBAAgB,EAAyB,MAAM,2BAA2B,CAAC;AAC9H,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAKzF,MAAM,OAAO,aAAa;IAGH;IAAuB;IAFnC,WAAW,GAAG,UAAU,EAAE,CAAC;IACpC,MAAM,GAA4E,EAAE,CAAC;IACrF,YAAqB,IAAY,EAAW,OAAsB;QAA7C,SAAI,GAAJ,IAAI,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IACtE,KAAK,CAAC,IAAa,EAAE,KAAc,EAAE,SAAmB,EAAE,cAAuC;QAC/F,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAAC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAAC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;YACnK,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;YAC1K,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7N,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YACvG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACvX,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC;YAAC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACrE,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;YAClmC,MAAM,MAAM,GAAG,IAAI,EAAE,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACzH,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpM,MAAM,YAAY,GAAG,SAAS,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;YAClL,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAwC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnL,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;QACnL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;IACtG,CAAC;IACD,QAAQ,CAAC,IAA8B,EAAE,QAAiB,EAAE,WAAoB;QAC9E,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC;QAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7G,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,IAAI,GAA4B,EAAE,CAAC;QACvC,IAAI,CAAC;YAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,8CAA8C,CAAC,CAAC;QAC/I,MAAM,QAAQ,GAAgC,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,eAAe,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9nB,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,SAAS,KAAK,UAAU;YAAE,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QAC9X,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IACtS,CAAC;CACF;AACD,SAAS,aAAa,CAAC,IAA6B,EAAE,IAAkB;IACtE,MAAM,OAAO,GAAsC,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IACrF,IAAI,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;QAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IAC/J,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAC9H,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChH,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACxG,IAAI,OAAO,IAAI,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IAC9F,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5J,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrM,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5H,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,SAAS,WAAW,CAAC,MAAe,EAAE,OAAiB,EAAE,EAAE,SAAmC,EAAE;IAC9F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAgB,CAAC;IACtI,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAAE,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/G,IAAI,IAAI,CAAC,KAAK;QAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAAE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC;gBAAE,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/I,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,KAAc,IAA6B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/K,SAAS,GAAG,CAAC,KAAa,IAAI,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC"}
@@ -0,0 +1,113 @@
1
+ import { z } from 'zod';
2
+ export declare const UsageResultSummarySchema: z.ZodObject<{
3
+ candidate_count: z.ZodOptional<z.ZodNumber>;
4
+ solution_handle: z.ZodOptional<z.ZodString>;
5
+ outcome_id: z.ZodOptional<z.ZodString>;
6
+ relation: z.ZodOptional<z.ZodString>;
7
+ result: z.ZodOptional<z.ZodEnum<{
8
+ solved: "solved";
9
+ failed: "failed";
10
+ inapplicable: "inapplicable";
11
+ inconclusive: "inconclusive";
12
+ regressed: "regressed";
13
+ }>>;
14
+ status: z.ZodOptional<z.ZodString>;
15
+ canonical_write: z.ZodOptional<z.ZodBoolean>;
16
+ created_solution_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
17
+ created_revisions: z.ZodOptional<z.ZodArray<z.ZodString>>;
18
+ source_project_keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
+ }, z.core.$strict>;
20
+ export declare const UsageStartSchema: z.ZodObject<{
21
+ invocation_id: z.ZodUUID;
22
+ collector_instance_id: z.ZodUUID;
23
+ request_id_hash: z.ZodDefault<z.ZodNullable<z.ZodString>>;
24
+ started_at: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>;
25
+ surface: z.ZodEnum<{
26
+ mcp: "mcp";
27
+ cli: "cli";
28
+ }>;
29
+ tool: z.ZodString;
30
+ package_version: z.ZodString;
31
+ schema_digest: z.ZodString;
32
+ normalization_version: z.ZodDefault<z.ZodNumber>;
33
+ client_name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
34
+ client_version: z.ZodDefault<z.ZodNullable<z.ZodString>>;
35
+ supplied_agent: z.ZodDefault<z.ZodNullable<z.ZodString>>;
36
+ supplied_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
37
+ project_key: z.ZodDefault<z.ZodNullable<z.ZodString>>;
38
+ investigation_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
39
+ retry_of: z.ZodDefault<z.ZodNullable<z.ZodString>>;
40
+ supplied_invocation_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
41
+ languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
42
+ platforms: z.ZodDefault<z.ZodArray<z.ZodString>>;
43
+ runtimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
44
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
45
+ source: z.ZodDefault<z.ZodEnum<{
46
+ live: "live";
47
+ codex_history: "codex_history";
48
+ }>>;
49
+ usage_kind: z.ZodDefault<z.ZodEnum<{
50
+ production: "production";
51
+ test: "test";
52
+ }>>;
53
+ confidence: z.ZodDefault<z.ZodEnum<{
54
+ observed: "observed";
55
+ confirmed: "confirmed";
56
+ inferred: "inferred";
57
+ unparsed: "unparsed";
58
+ }>>;
59
+ source_identity: z.ZodDefault<z.ZodNullable<z.ZodString>>;
60
+ import_provenance: z.ZodOptional<z.ZodObject<{
61
+ parser_version: z.ZodLiteral<1>;
62
+ source_file_hash: z.ZodString;
63
+ stable_call_identity: z.ZodString;
64
+ overlap: z.ZodLiteral<"overlap_unknown">;
65
+ expression_index: z.ZodNumber;
66
+ response_confirmed: z.ZodBoolean;
67
+ }, z.core.$strict>>;
68
+ }, z.core.$strict>;
69
+ export declare const UsageCompletionSchema: z.ZodObject<{
70
+ ended_at: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>;
71
+ duration_ms: z.ZodNullable<z.ZodNumber>;
72
+ status: z.ZodDefault<z.ZodEnum<{
73
+ completed: "completed";
74
+ interrupted: "interrupted";
75
+ }>>;
76
+ category: z.ZodNullable<z.ZodEnum<{
77
+ success: "success";
78
+ validation_error: "validation_error";
79
+ domain_error: "domain_error";
80
+ protocol_error: "protocol_error";
81
+ candidates_exhausted: "candidates_exhausted";
82
+ no_results: "no_results";
83
+ }>>;
84
+ result_summary: z.ZodDefault<z.ZodObject<{
85
+ candidate_count: z.ZodOptional<z.ZodNumber>;
86
+ solution_handle: z.ZodOptional<z.ZodString>;
87
+ outcome_id: z.ZodOptional<z.ZodString>;
88
+ relation: z.ZodOptional<z.ZodString>;
89
+ result: z.ZodOptional<z.ZodEnum<{
90
+ solved: "solved";
91
+ failed: "failed";
92
+ inapplicable: "inapplicable";
93
+ inconclusive: "inconclusive";
94
+ regressed: "regressed";
95
+ }>>;
96
+ status: z.ZodOptional<z.ZodString>;
97
+ canonical_write: z.ZodOptional<z.ZodBoolean>;
98
+ created_solution_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
99
+ created_revisions: z.ZodOptional<z.ZodArray<z.ZodString>>;
100
+ source_project_keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
101
+ }, z.core.$strict>>;
102
+ diagnostic_ref: z.ZodDefault<z.ZodNullable<z.ZodUUID>>;
103
+ }, z.core.$strict>;
104
+ export type UsageStart = z.infer<typeof UsageStartSchema>;
105
+ export type UsageCompletion = z.infer<typeof UsageCompletionSchema>;
106
+ export type UsageEvent = UsageStart & {
107
+ status: 'started' | 'completed' | 'interrupted';
108
+ ended_at: string | null;
109
+ duration_ms: number | null;
110
+ category: UsageCompletion['category'];
111
+ result_summary: z.infer<typeof UsageResultSummarySchema>;
112
+ diagnostic_ref: string | null;
113
+ };
@@ -0,0 +1,33 @@
1
+ import { z } from 'zod';
2
+ import { redactSensitiveText } from './redaction.js';
3
+ const label = z.string().min(1).max(128).refine((value) => !/[\x00-\x1f\x7f]/.test(value) && redactSensitiveText(value) === value, 'Expected safe metadata');
4
+ const hash = z.string().regex(/^sha256:[a-f0-9]{64}$/);
5
+ const nullableLabel = label.nullable().default(null);
6
+ const facets = z.array(label).max(32).default([]);
7
+ export const UsageResultSummarySchema = z.object({
8
+ candidate_count: z.number().int().nonnegative().optional(), solution_handle: label.optional(), outcome_id: label.optional(), relation: label.optional(),
9
+ result: z.enum(['solved', 'failed', 'inapplicable', 'inconclusive', 'regressed']).optional(),
10
+ status: label.optional(), canonical_write: z.boolean().optional(),
11
+ created_solution_ids: z.array(label).max(100).optional(), created_revisions: z.array(label).max(100).optional(),
12
+ source_project_keys: z.array(label).max(100).optional(),
13
+ }).strict();
14
+ export const UsageStartSchema = z.object({
15
+ invocation_id: z.uuid(), collector_instance_id: z.uuid(), request_id_hash: hash.nullable().default(null),
16
+ started_at: z.iso.datetime().transform((value) => new Date(value).toISOString()), surface: z.enum(['mcp', 'cli']), tool: label,
17
+ package_version: label, schema_digest: hash, normalization_version: z.number().int().positive().default(1),
18
+ client_name: nullableLabel, client_version: nullableLabel, supplied_agent: nullableLabel, supplied_model: nullableLabel,
19
+ project_key: z.string().regex(/^[a-z0-9][a-z0-9._-]{0,127}$/).refine((value) => redactSensitiveText(value) === value, 'Expected safe project metadata').nullable().default(null),
20
+ investigation_id: nullableLabel, retry_of: nullableLabel,
21
+ supplied_invocation_id: nullableLabel,
22
+ languages: facets, platforms: facets, runtimes: facets, tools: facets,
23
+ source: z.enum(['live', 'codex_history']).default('live'), usage_kind: z.enum(['production', 'test']).default('production'), confidence: z.enum(['observed', 'confirmed', 'inferred', 'unparsed']).default('observed'),
24
+ source_identity: hash.nullable().default(null),
25
+ import_provenance: z.object({ parser_version: z.literal(1), source_file_hash: hash, stable_call_identity: hash, overlap: z.literal('overlap_unknown'), expression_index: z.number().int().nonnegative(), response_confirmed: z.boolean() }).strict().optional(),
26
+ }).strict();
27
+ export const UsageCompletionSchema = z.object({
28
+ ended_at: z.iso.datetime().transform((value) => new Date(value).toISOString()), duration_ms: z.number().finite().nonnegative().nullable(),
29
+ status: z.enum(['completed', 'interrupted']).default('completed'),
30
+ category: z.enum(['success', 'validation_error', 'domain_error', 'protocol_error', 'no_results', 'candidates_exhausted']).nullable(),
31
+ result_summary: UsageResultSummarySchema.default({}), diagnostic_ref: z.uuid().nullable().default(null),
32
+ }).strict();
33
+ //# sourceMappingURL=usage-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-schema.js","sourceRoot":"","sources":["../../src/core/usage-schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ export function readFilters(search) {
2
+ const query = new URLSearchParams(search);
3
+ return { period: query.get('all') === 'true' ? 'all' : query.get('days') ?? '30', project: query.get('project_key') ?? '', language: query.get('language') ?? '', source: query.get('source') ?? 'live', timezone: query.get('timezone') ?? 'UTC' };
4
+ }
5
+ export function filterQuery(filters) {
6
+ const query = new URLSearchParams({ source: filters.source, timezone: filters.timezone });
7
+ query.set(filters.period === 'all' ? 'all' : 'days', filters.period === 'all' ? 'true' : filters.period);
8
+ if (filters.project)
9
+ query.set('project_key', filters.project);
10
+ if (filters.language)
11
+ query.set('language', filters.language);
12
+ return query;
13
+ }
14
+ export function filtersUrl(current, filters) {
15
+ const url = new URL(current);
16
+ url.search = filterQuery(filters).toString();
17
+ return url;
18
+ }
19
+ export function shouldPoll(enabled, visibility) { return enabled && visibility === 'visible'; }
20
+ export class LatestRequest {
21
+ sequence = 0;
22
+ controller;
23
+ cancel() { this.sequence++; this.controller?.abort(); }
24
+ async get(url) {
25
+ this.cancel();
26
+ const sequence = this.sequence;
27
+ const controller = this.controller = new AbortController();
28
+ try {
29
+ const response = await fetch(url, { signal: controller.signal });
30
+ if (!response.ok)
31
+ throw new Error(response.status === 400 ? 'Invalid filters. Check the period, project key, language and timezone.' : 'The local server could not complete this request.');
32
+ const data = await response.json();
33
+ return sequence === this.sequence ? { data } : undefined;
34
+ }
35
+ catch (error) {
36
+ if (sequence !== this.sequence || controller.signal.aborted)
37
+ return undefined;
38
+ return { error: error instanceof Error && error.message.startsWith('Invalid filters.') ? error.message : 'Connection unavailable. Check the local dashboard server and retry.' };
39
+ }
40
+ }
41
+ }
@@ -0,0 +1,111 @@
1
+ import { appShell, element, filterBar, stateNotice } from './components/index.js';
2
+ import { filterQuery, filtersUrl, LatestRequest, readFilters, shouldPoll } from './api.js';
3
+ import { renderOverview } from './overview.js';
4
+ import { knowledgeQuery, renderKnowledge } from './knowledge.js';
5
+ import { solutionDetail } from './solution-detail.js';
6
+ import { detailPanel } from './components/detail-panel.js';
7
+ import { diagnosticQuery, renderDiagnostics } from './diagnostics.js';
8
+ import { diagnosticDetail } from './diagnostic-detail.js';
9
+ const main = document.getElementById('main');
10
+ const connection = document.getElementById('connection');
11
+ const refresh = document.getElementById('refresh');
12
+ refresh.textContent = 'Refresh statistics';
13
+ const request = new LatestRequest();
14
+ let autoRefresh = false;
15
+ let last;
16
+ let generation = 0;
17
+ let restoreFocus;
18
+ function page() { const value = location.hash.slice(1); return ['knowledge', 'diagnostics'].includes(value) ? value : 'overview'; }
19
+ function navigate(url) { history.pushState(null, '', url); void checkConnection(); }
20
+ function changeQuery(fields) { const url = new URL(location.href); for (const [key, value] of Object.entries(fields))
21
+ value === null ? url.searchParams.delete(key) : url.searchParams.set(key, value); navigate(url); }
22
+ async function checkConnection() {
23
+ const ticket = ++generation;
24
+ const currentPage = page();
25
+ appShell(currentPage);
26
+ const filters = readFilters(location.search);
27
+ const key = `${currentPage}?${location.search}`;
28
+ const title = element('h1', currentPage === 'overview' ? 'Overview' : currentPage === 'knowledge' ? 'Knowledge' : 'Diagnostics');
29
+ const intro = element('div');
30
+ intro.append(title, element('p', currentPage === 'overview' ? 'Every search. Every solution. A little more knowledge.' : currentPage === 'knowledge' ? 'Find the knowledge your agents can use again.' : 'Understand rejected calls and improve the next attempt.', 'page-description'));
31
+ const filtersNode = filterBar(filters, (values) => navigate(filtersUrl(location.href, values)));
32
+ const toolbar = element('div', undefined, 'toolbar');
33
+ const label = element('label', 'Auto refresh every 30 seconds', 'toggle-label');
34
+ const checkbox = element('input');
35
+ checkbox.type = 'checkbox';
36
+ checkbox.checked = autoRefresh;
37
+ checkbox.addEventListener('change', () => { autoRefresh = checkbox.checked; });
38
+ label.prepend(checkbox);
39
+ toolbar.append(label);
40
+ const pageHeading = element('div', undefined, 'page-heading');
41
+ pageHeading.append(intro, toolbar);
42
+ const notices = element('div');
43
+ const content = element('div');
44
+ if (last?.key === key) {
45
+ content.append(last.node);
46
+ notices.append(stateNotice('refreshing', 'Showing the previous snapshot while refreshing.'));
47
+ }
48
+ else
49
+ notices.append(stateNotice('loading', 'Loading local knowledge and usage…'));
50
+ main.replaceChildren(pageHeading, filtersNode, notices, content);
51
+ main.setAttribute('aria-busy', 'true');
52
+ refresh.disabled = true;
53
+ connection.textContent = 'Refreshing local data…';
54
+ connection.dataset.state = 'refreshing';
55
+ const endpoint = currentPage === 'knowledge' ? `/api/knowledge?${knowledgeQuery(location.search)}` : currentPage === 'diagnostics' ? `/api/diagnostics?${diagnosticQuery(location.search)}` : `/api/stats?${filterQuery(filters)}`;
56
+ const result = await request.get(endpoint);
57
+ if (!result)
58
+ return;
59
+ main.setAttribute('aria-busy', 'false');
60
+ refresh.disabled = false;
61
+ if ('error' in result) {
62
+ notices.replaceChildren(stateNotice(last?.key === key ? 'stale' : 'error', result.error, () => { void checkConnection(); }));
63
+ connection.textContent = 'Refresh failed';
64
+ connection.dataset.state = 'error';
65
+ return;
66
+ }
67
+ connection.textContent = 'Connected · read-only';
68
+ connection.dataset.state = 'connected';
69
+ notices.replaceChildren();
70
+ const node = currentPage === 'overview' ? renderOverview(result.data) : currentPage === 'knowledge' ? renderKnowledge(result.data, location.search, changeQuery) : renderDiagnostics(result.data, location.search, changeQuery);
71
+ content.replaceChildren(node);
72
+ last = { key, node };
73
+ if (restoreFocus) {
74
+ const button = [...node.querySelectorAll('button[data-focus-key]')].find(b => b.dataset.focusKey === restoreFocus);
75
+ button?.focus();
76
+ restoreFocus = undefined;
77
+ }
78
+ const detail = new URLSearchParams(location.search).get('detail');
79
+ if (currentPage === 'knowledge' && detail) {
80
+ const query = filterQuery(filters);
81
+ query.delete('days');
82
+ query.set('all', 'true');
83
+ const detailed = await request.get(`/api/knowledge/${encodeURIComponent(detail)}?${query}`);
84
+ if (!detailed || ticket !== generation)
85
+ return;
86
+ const unavailable = 'error' in detailed || detailed.data.status !== 'ok';
87
+ const contents = unavailable ? stateNotice('error', 'Record unavailable. Check filters and local storage health, then refresh.') : solutionDetail(detailed.data.items[0]);
88
+ const dialog = detailPanel(unavailable ? 'Record unavailable' : 'data' in detailed ? detailed.data.items[0]?.title ?? 'Record not found' : 'Record unavailable', contents, () => { restoreFocus = detail; changeQuery({ detail: null }); });
89
+ node.append(dialog);
90
+ }
91
+ else if (currentPage === 'diagnostics' && detail) {
92
+ const query = filterQuery(filters);
93
+ query.delete('days');
94
+ query.set('all', 'true');
95
+ const detailed = await request.get(`/api/diagnostics/${encodeURIComponent(detail)}?${query}`);
96
+ if (!detailed || ticket !== generation)
97
+ return;
98
+ const contents = 'error' in detailed ? stateNotice('error', detailed.error) : detailed.data.status === 'degraded' ? stateNotice('error', 'Diagnostic storage is unavailable.') : diagnosticDetail(detailed.data.details[0]);
99
+ node.append(detailPanel('Rejected call details', contents, () => { restoreFocus = detail; changeQuery({ detail: null }); }));
100
+ }
101
+ }
102
+ document.querySelector('.skip-link')?.addEventListener('click', (event) => { event.preventDefault(); main.focus(); main.scrollIntoView({ block: 'start' }); });
103
+ for (const link of document.querySelectorAll('nav a'))
104
+ link.addEventListener('click', (event) => { event.preventDefault(); const url = filtersUrl(location.href, readFilters(location.search)); url.hash = link.dataset.page ?? 'overview'; navigate(url); });
105
+ refresh.addEventListener('click', () => { void checkConnection(); });
106
+ window.addEventListener('popstate', () => { void checkConnection(); });
107
+ window.addEventListener('hashchange', () => { void checkConnection(); });
108
+ const timer = setInterval(() => { if (shouldPoll(autoRefresh, document.visibilityState) && !document.querySelector('dialog[open]'))
109
+ void checkConnection(); }, 30_000);
110
+ window.addEventListener('pagehide', () => { clearInterval(timer); request.cancel(); });
111
+ void checkConnection();
@@ -0,0 +1,21 @@
1
+ import { element } from './index.js';
2
+ let nextId = 0;
3
+ export function detailPanel(title, content, onClose) {
4
+ const dialog = element('dialog', undefined, 'detail-panel');
5
+ const heading = element('h2', title);
6
+ heading.id = `detail-title-${++nextId}`;
7
+ heading.tabIndex = -1;
8
+ dialog.setAttribute('aria-labelledby', heading.id);
9
+ const close = element('button', 'Close details');
10
+ close.type = 'button';
11
+ close.addEventListener('click', onClose);
12
+ const header = element('div', undefined, 'toolbar');
13
+ header.append(heading, close);
14
+ dialog.append(header, content);
15
+ dialog.addEventListener('cancel', (event) => { event.preventDefault(); onClose(); });
16
+ queueMicrotask(() => { if (dialog.isConnected) {
17
+ dialog.showModal();
18
+ heading.focus();
19
+ } });
20
+ return dialog;
21
+ }