@warlock.js/ai-panoptic 5.31.0 → 5.32.0

package/esm/collector/collector.d.mts

@@ -1,6 +1,5 @@
 import { CollectorContract } from "../contracts/collector.contract.mjs";
 import { ContentCaptureOptions } from "./content-capture.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/collector/collector.d.ts
 /**
  * Notified when a registered exporter throws during `collect` / `flush` /
@@ -8,9 +7,9 @@ import { ContentCaptureOptions } from "./content-capture.type.mjs";
  * it) — this is purely a chance to surface it (route to your logger,
  * bump a metric). Receives the exporter's `name` and the thrown error.
  */
-type ExporterErrorHandler = (exporterName: string, error: unknown) => void;
+export type ExporterErrorHandler = (exporterName: string, error: unknown) => void;
 /** Options for {@link createCollector}. */
-type CollectorOptions = ContentCaptureOptions & {
+export type CollectorOptions = ContentCaptureOptions & {
   /**
    * Called when an exporter throws (and is isolated). Overrides the default
    * one-time `console.warn` per exporter — route the failure to your own
@@ -31,7 +30,6 @@ type CollectorOptions = ContentCaptureOptions & {
  * // on shutdown:
  * await collector.shutdown();
  */
-declare function createCollector(options?: CollectorOptions): CollectorContract;
+export declare function createCollector(options?: CollectorOptions): CollectorContract;
 //#endregion
-export { CollectorOptions, ExporterErrorHandler, createCollector };
 //# sourceMappingURL=collector.d.mts.map

package/esm/collector/collector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/collector.ts"],"mappings":";;;;;;AAcA;;;;KAAY,oBAAA,IAAwB,YAAA,UAAsB,KAAc;AAGxE;AAAA,KAAY,gBAAA,GAAmB,qBAAA;;;;;;;EAO7B,OAAA,GAAU,oBAAoB;AAAA;;;;;;;;AAyJkD;;;;;iBAAlE,eAAA,CAAgB,OAAA,GAAS,gBAAA,GAAwB,iBAAiB"}
+{"version":3,"file":"collector.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/collector.ts"],"mappings":";;;;;;;;;YAcY,wBAAwB,sBAAsB;;YAG9C,mBAAmB;;;;;;;EAO7B,UAAU;;;;;;;;;;;;;;wBAyJI,gBAAgB,UAAS,mBAAwB"}

package/esm/collector/content-capture.type.d.mts

@@ -1,5 +1,4 @@
 import { ReportType } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/collector/content-capture.type.d.ts
 /**
  * Masker applied to each captured content value before it lands on a
@@ -12,7 +11,7 @@ import { ReportType } from "@warlock.js/ai";
  * const redactContent: ContentRedactor = (value, { field }) =>
  *   field === "input" ? "[redacted prompt]" : value;
  */
-type ContentRedactor = (value: unknown, meta: {
+export type ContentRedactor = (value: unknown, meta: {
   name: string;
   type: ReportType;
   field: "input" | "output";
@@ -29,12 +28,13 @@ type ContentRedactor = (value: unknown, meta: {
  * OTel `gen_ai.prompt` / `gen_ai.completion`, and Langfuse
  * `input` / `output`.
  */
-type ContentCaptureOptions = {
+export type ContentCaptureOptions = {
   /**
    * Copy the agent's first-trip prompt + final response, and each tool's
    * args + result, onto `span.input` / `span.output`. Default `false`.
    */
-  captureContent?: boolean; /** Optional masker applied to every captured value before it is stored. */
+  captureContent?: boolean;
+  /** Optional masker applied to every captured value before it is stored. */
   redactContent?: ContentRedactor;
   /**
    * When `true`, emit the agent's complete `CapturedMessage[]` (every
@@ -48,5 +48,4 @@ type ContentCaptureOptions = {
   fullHistory?: boolean;
 };
 //#endregion
-export { ContentCaptureOptions, ContentRedactor };
 //# sourceMappingURL=content-capture.type.d.mts.map

package/esm/collector/content-capture.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"content-capture.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/content-capture.type.ts"],"mappings":";;;;;AAaA;;;;;;;;;KAAY,eAAA,IACV,KAAA,WACA,IAAA;EAAQ,IAAA;EAAc,IAAA,EAAM,UAAU;EAAE,KAAA;AAAA;;;;;;;;AAgC7B;;;;;KAjBD,qBAAA;;;;;EAKV,cAAA;EAEA,aAAA,GAAgB,eAAe;;;;;;;;;;EAU/B,WAAA;AAAA"}
+{"version":3,"file":"content-capture.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/content-capture.type.ts"],"mappings":";;;;;;;;;;;;;YAaY,mBACV,gBACA;EAAQ;EAAc,MAAM;EAAY;;;;;;;;;;;;;;YAe9B;;;;;EAKV;;EAEA,gBAAgB;;;;;;;;;;EAUhB"}

package/esm/collector/extract-span-attributes.d.mts

@@ -1,5 +1,4 @@
 import { BaseReport } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/collector/extract-span-attributes.d.ts
 /**
  * Build the free-form `TraceSpan.attributes` bag for one report node.
@@ -23,7 +22,6 @@ import { BaseReport } from "@warlock.js/ai";
  * const attributes = extractSpanAttributes(agentReport);
  * // { "agent.trips": 3, "agent.model.name": "gpt-4o", "agent.model.provider": "openai" }
  */
-declare function extractSpanAttributes(report: BaseReport): Record<string, unknown> | undefined;
+export declare function extractSpanAttributes(report: BaseReport): Record<string, unknown> | undefined;
 //#endregion
-export { extractSpanAttributes };
 //# sourceMappingURL=extract-span-attributes.d.mts.map

package/esm/collector/extract-span-attributes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-span-attributes.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/extract-span-attributes.ts"],"mappings":";;;;;AAwDA;;;;;;;;AAAiE;;;;;;;;;;;;iBAAjD,qBAAA,CAAsB,MAAA,EAAQ,UAAA,GAAa,MAAM"}
+{"version":3,"file":"extract-span-attributes.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/extract-span-attributes.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBAwDgB,sBAAsB,QAAQ,aAAa"}

package/esm/collector/extract-span-attributes.mjs

@@ -39,10 +39,7 @@ function extractSpanAttributes(report) {
 		case "orchestrator":
 			addOrchestratorAttributes(attributes, extensions);
 			break;
-		case "tool":
-			addToolAttributes(attributes, extensions);
-			break;
-		default: break;
+		case "tool": addToolAttributes(attributes, extensions);
 	}
 	if (Object.keys(attributes).length === 0) return;
 	return attributes;

package/esm/collector/extract-span-attributes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extract-span-attributes.mjs","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/extract-span-attributes.ts"],"sourcesContent":["import type { BaseReport } from \"@warlock.js/ai\";\n\n/**\n * Per-primitive `BaseReport` extension fields the collector surfaces as\n * span attributes. Declared as a structural superset (every field\n * optional) so a single reader can pull whatever the concrete report\n * carried without narrowing on `type` first — a `BaseReport` widened to\n * this shape exposes `undefined` for the fields its primitive doesn't\n * set, and the extractor simply skips those.\n *\n * Mirrors the public per-primitive report types in `@warlock.js/ai`\n * (`AgentReport`, `WorkflowReport`, `SupervisorReport`,\n * `OrchestratorReport`, `ToolCall`) — kept structural rather than a\n * union import so adding a new optional report field upstream is a\n * non-breaking read here.\n */\ntype ReportExtensions = {\n  model?: { name?: string; provider?: string };\n  trips?: unknown[];\n  promptName?: string;\n  promptVersion?: string;\n  workflowName?: string;\n  supervisorName?: string;\n  signature?: string;\n  terminatedBy?: string;\n  iterations?: number;\n  steps?: Record<string, unknown>;\n  turns?: unknown[];\n  turnIndex?: number;\n  tripIndex?: number;\n  callId?: string;\n  recoveredFrom?: string;\n};\n\n/**\n * Build the free-form `TraceSpan.attributes` bag for one report node.\n *\n * The collector keeps the first-class span fields (identity, timing,\n * status, usage, error) on the span itself and routes everything\n * primitive-specific here — trip/step/iteration counts, the model\n * identity an agent ran against, the tool's originating trip index, a\n * supervisor's termination reason. Exporters forward this verbatim as\n * backend span attributes (OTel attributes, Langfuse metadata).\n *\n * Only populated keys are emitted; the function returns `undefined`\n * when the node carried no extra detail, so the optional\n * `TraceSpan.attributes` field stays absent rather than holding an\n * empty object (matches the contract's \"absent when empty\" note).\n *\n * Retry count is surfaced from the shared `BaseReport.attempts` for\n * every primitive so cost dashboards see the real call count.\n *\n * @example\n * const attributes = extractSpanAttributes(agentReport);\n * // { \"agent.trips\": 3, \"agent.model.name\": \"gpt-4o\", \"agent.model.provider\": \"openai\" }\n */\nexport function extractSpanAttributes(report: BaseReport): Record<string, unknown> | undefined {\n  const extensions = report as BaseReport & ReportExtensions;\n  const attributes: Record<string, unknown> = {};\n\n  if (report.attempts !== undefined && report.attempts.length > 0) {\n    attributes[\"retries\"] = report.attempts.length;\n  }\n\n  switch (report.type) {\n    case \"agent\": {\n      addAgentAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"workflow\": {\n      addWorkflowAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"supervisor\":\n    case \"team\": {\n      // ai.team reuses the supervisor engine, so a team report carries the\n      // same supervisorName / terminatedBy / iterations fields.\n      addSupervisorAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"orchestrator\": {\n      addOrchestratorAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"tool\": {\n      addToolAttributes(attributes, extensions);\n      break;\n    }\n\n    default: {\n      break;\n    }\n  }\n\n  if (Object.keys(attributes).length === 0) {\n    return undefined;\n  }\n\n  return attributes;\n}\n\nfunction addAgentAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (Array.isArray(extensions.trips)) {\n    attributes[\"agent.trips\"] = extensions.trips.length;\n  }\n\n  if (extensions.model?.name !== undefined) {\n    attributes[\"agent.model.name\"] = extensions.model.name;\n  }\n\n  if (extensions.model?.provider !== undefined) {\n    attributes[\"agent.model.provider\"] = extensions.model.provider;\n  }\n\n  // Prompt-version linkage (core `AgentReport.promptName` / `promptVersion`).\n  // Present only when the agent ran against a *named* `ai.prompts` builder;\n  // surfaced so the dashboard can group / filter runs by `name@version` and\n  // attribute behavior shifts to a specific prompt revision.\n  if (extensions.promptName !== undefined) {\n    attributes[\"agent.promptName\"] = extensions.promptName;\n  }\n\n  if (extensions.promptVersion !== undefined) {\n    attributes[\"agent.promptVersion\"] = extensions.promptVersion;\n  }\n}\n\nfunction addWorkflowAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.workflowName !== undefined) {\n    attributes[\"workflow.name\"] = extensions.workflowName;\n  }\n\n  if (extensions.signature !== undefined) {\n    attributes[\"workflow.signature\"] = extensions.signature;\n  }\n\n  if (extensions.steps !== undefined) {\n    attributes[\"workflow.steps\"] = Object.keys(extensions.steps).length;\n  }\n}\n\nfunction addSupervisorAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.supervisorName !== undefined) {\n    attributes[\"supervisor.name\"] = extensions.supervisorName;\n  }\n\n  if (extensions.terminatedBy !== undefined) {\n    attributes[\"supervisor.terminatedBy\"] = extensions.terminatedBy;\n  }\n\n  if (extensions.iterations !== undefined) {\n    attributes[\"supervisor.iterations\"] = extensions.iterations;\n  }\n}\n\nfunction addOrchestratorAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.turnIndex !== undefined) {\n    attributes[\"orchestrator.turnIndex\"] = extensions.turnIndex;\n  }\n\n  if (extensions.signature !== undefined) {\n    attributes[\"orchestrator.signature\"] = extensions.signature;\n  }\n\n  if (Array.isArray(extensions.turns)) {\n    attributes[\"orchestrator.turns\"] = extensions.turns.length;\n  }\n}\n\nfunction addToolAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.tripIndex !== undefined) {\n    attributes[\"tool.tripIndex\"] = extensions.tripIndex;\n  }\n\n  if (extensions.callId !== undefined) {\n    attributes[\"tool.callId\"] = extensions.callId;\n  }\n\n  if (extensions.recoveredFrom !== undefined) {\n    attributes[\"tool.recoveredFrom\"] = extensions.recoveredFrom;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,sBAAsB,QAAyD;CAC7F,MAAM,aAAa;CACnB,MAAM,aAAsC,CAAC;CAE7C,IAAI,OAAO,aAAa,UAAa,OAAO,SAAS,SAAS,GAC5D,WAAW,aAAa,OAAO,SAAS;CAG1C,QAAQ,OAAO,MAAf;EACE,KAAK;GACH,mBAAmB,YAAY,UAAU;GACzC;EAGF,KAAK;GACH,sBAAsB,YAAY,UAAU;GAC5C;EAGF,KAAK;EACL,KAAK;GAGH,wBAAwB,YAAY,UAAU;GAC9C;EAGF,KAAK;GACH,0BAA0B,YAAY,UAAU;GAChD;EAGF,KAAK;GACH,kBAAkB,YAAY,UAAU;GACxC;EAGF,SACE;CAEJ;CAEA,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,WAAW,GACrC;CAGF,OAAO;AACT;AAEA,SAAS,mBACP,YACA,YACM;CACN,IAAI,MAAM,QAAQ,WAAW,KAAK,GAChC,WAAW,iBAAiB,WAAW,MAAM;CAG/C,IAAI,WAAW,OAAO,SAAS,QAC7B,WAAW,sBAAsB,WAAW,MAAM;CAGpD,IAAI,WAAW,OAAO,aAAa,QACjC,WAAW,0BAA0B,WAAW,MAAM;CAOxD,IAAI,WAAW,eAAe,QAC5B,WAAW,sBAAsB,WAAW;CAG9C,IAAI,WAAW,kBAAkB,QAC/B,WAAW,yBAAyB,WAAW;AAEnD;AAEA,SAAS,sBACP,YACA,YACM;CACN,IAAI,WAAW,iBAAiB,QAC9B,WAAW,mBAAmB,WAAW;CAG3C,IAAI,WAAW,cAAc,QAC3B,WAAW,wBAAwB,WAAW;CAGhD,IAAI,WAAW,UAAU,QACvB,WAAW,oBAAoB,OAAO,KAAK,WAAW,KAAK,CAAC,CAAC;AAEjE;AAEA,SAAS,wBACP,YACA,YACM;CACN,IAAI,WAAW,mBAAmB,QAChC,WAAW,qBAAqB,WAAW;CAG7C,IAAI,WAAW,iBAAiB,QAC9B,WAAW,6BAA6B,WAAW;CAGrD,IAAI,WAAW,eAAe,QAC5B,WAAW,2BAA2B,WAAW;AAErD;AAEA,SAAS,0BACP,YACA,YACM;CACN,IAAI,WAAW,cAAc,QAC3B,WAAW,4BAA4B,WAAW;CAGpD,IAAI,WAAW,cAAc,QAC3B,WAAW,4BAA4B,WAAW;CAGpD,IAAI,MAAM,QAAQ,WAAW,KAAK,GAChC,WAAW,wBAAwB,WAAW,MAAM;AAExD;AAEA,SAAS,kBACP,YACA,YACM;CACN,IAAI,WAAW,cAAc,QAC3B,WAAW,oBAAoB,WAAW;CAG5C,IAAI,WAAW,WAAW,QACxB,WAAW,iBAAiB,WAAW;CAGzC,IAAI,WAAW,kBAAkB,QAC/B,WAAW,wBAAwB,WAAW;AAElD"}
+{"version":3,"file":"extract-span-attributes.mjs","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/extract-span-attributes.ts"],"sourcesContent":["import type { BaseReport } from \"@warlock.js/ai\";\n\n/**\n * Per-primitive `BaseReport` extension fields the collector surfaces as\n * span attributes. Declared as a structural superset (every field\n * optional) so a single reader can pull whatever the concrete report\n * carried without narrowing on `type` first — a `BaseReport` widened to\n * this shape exposes `undefined` for the fields its primitive doesn't\n * set, and the extractor simply skips those.\n *\n * Mirrors the public per-primitive report types in `@warlock.js/ai`\n * (`AgentReport`, `WorkflowReport`, `SupervisorReport`,\n * `OrchestratorReport`, `ToolCall`) — kept structural rather than a\n * union import so adding a new optional report field upstream is a\n * non-breaking read here.\n */\ntype ReportExtensions = {\n  model?: { name?: string; provider?: string };\n  trips?: unknown[];\n  promptName?: string;\n  promptVersion?: string;\n  workflowName?: string;\n  supervisorName?: string;\n  signature?: string;\n  terminatedBy?: string;\n  iterations?: number;\n  steps?: Record<string, unknown>;\n  turns?: unknown[];\n  turnIndex?: number;\n  tripIndex?: number;\n  callId?: string;\n  recoveredFrom?: string;\n};\n\n/**\n * Build the free-form `TraceSpan.attributes` bag for one report node.\n *\n * The collector keeps the first-class span fields (identity, timing,\n * status, usage, error) on the span itself and routes everything\n * primitive-specific here — trip/step/iteration counts, the model\n * identity an agent ran against, the tool's originating trip index, a\n * supervisor's termination reason. Exporters forward this verbatim as\n * backend span attributes (OTel attributes, Langfuse metadata).\n *\n * Only populated keys are emitted; the function returns `undefined`\n * when the node carried no extra detail, so the optional\n * `TraceSpan.attributes` field stays absent rather than holding an\n * empty object (matches the contract's \"absent when empty\" note).\n *\n * Retry count is surfaced from the shared `BaseReport.attempts` for\n * every primitive so cost dashboards see the real call count.\n *\n * @example\n * const attributes = extractSpanAttributes(agentReport);\n * // { \"agent.trips\": 3, \"agent.model.name\": \"gpt-4o\", \"agent.model.provider\": \"openai\" }\n */\nexport function extractSpanAttributes(report: BaseReport): Record<string, unknown> | undefined {\n  const extensions = report as BaseReport & ReportExtensions;\n  const attributes: Record<string, unknown> = {};\n\n  if (report.attempts !== undefined && report.attempts.length > 0) {\n    attributes[\"retries\"] = report.attempts.length;\n  }\n\n  switch (report.type) {\n    case \"agent\": {\n      addAgentAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"workflow\": {\n      addWorkflowAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"supervisor\":\n    case \"team\": {\n      // ai.team reuses the supervisor engine, so a team report carries the\n      // same supervisorName / terminatedBy / iterations fields.\n      addSupervisorAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"orchestrator\": {\n      addOrchestratorAttributes(attributes, extensions);\n      break;\n    }\n\n    case \"tool\": {\n      addToolAttributes(attributes, extensions);\n      break;\n    }\n\n    default: {\n      break;\n    }\n  }\n\n  if (Object.keys(attributes).length === 0) {\n    return undefined;\n  }\n\n  return attributes;\n}\n\nfunction addAgentAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (Array.isArray(extensions.trips)) {\n    attributes[\"agent.trips\"] = extensions.trips.length;\n  }\n\n  if (extensions.model?.name !== undefined) {\n    attributes[\"agent.model.name\"] = extensions.model.name;\n  }\n\n  if (extensions.model?.provider !== undefined) {\n    attributes[\"agent.model.provider\"] = extensions.model.provider;\n  }\n\n  // Prompt-version linkage (core `AgentReport.promptName` / `promptVersion`).\n  // Present only when the agent ran against a *named* `ai.prompts` builder;\n  // surfaced so the dashboard can group / filter runs by `name@version` and\n  // attribute behavior shifts to a specific prompt revision.\n  if (extensions.promptName !== undefined) {\n    attributes[\"agent.promptName\"] = extensions.promptName;\n  }\n\n  if (extensions.promptVersion !== undefined) {\n    attributes[\"agent.promptVersion\"] = extensions.promptVersion;\n  }\n}\n\nfunction addWorkflowAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.workflowName !== undefined) {\n    attributes[\"workflow.name\"] = extensions.workflowName;\n  }\n\n  if (extensions.signature !== undefined) {\n    attributes[\"workflow.signature\"] = extensions.signature;\n  }\n\n  if (extensions.steps !== undefined) {\n    attributes[\"workflow.steps\"] = Object.keys(extensions.steps).length;\n  }\n}\n\nfunction addSupervisorAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.supervisorName !== undefined) {\n    attributes[\"supervisor.name\"] = extensions.supervisorName;\n  }\n\n  if (extensions.terminatedBy !== undefined) {\n    attributes[\"supervisor.terminatedBy\"] = extensions.terminatedBy;\n  }\n\n  if (extensions.iterations !== undefined) {\n    attributes[\"supervisor.iterations\"] = extensions.iterations;\n  }\n}\n\nfunction addOrchestratorAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.turnIndex !== undefined) {\n    attributes[\"orchestrator.turnIndex\"] = extensions.turnIndex;\n  }\n\n  if (extensions.signature !== undefined) {\n    attributes[\"orchestrator.signature\"] = extensions.signature;\n  }\n\n  if (Array.isArray(extensions.turns)) {\n    attributes[\"orchestrator.turns\"] = extensions.turns.length;\n  }\n}\n\nfunction addToolAttributes(\n  attributes: Record<string, unknown>,\n  extensions: ReportExtensions,\n): void {\n  if (extensions.tripIndex !== undefined) {\n    attributes[\"tool.tripIndex\"] = extensions.tripIndex;\n  }\n\n  if (extensions.callId !== undefined) {\n    attributes[\"tool.callId\"] = extensions.callId;\n  }\n\n  if (extensions.recoveredFrom !== undefined) {\n    attributes[\"tool.recoveredFrom\"] = extensions.recoveredFrom;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,sBAAsB,QAAyD;CAC7F,MAAM,aAAa;CACnB,MAAM,aAAsC,CAAC;CAE7C,IAAI,OAAO,aAAa,UAAa,OAAO,SAAS,SAAS,GAC5D,WAAW,aAAa,OAAO,SAAS;CAG1C,QAAQ,OAAO,MAAf;EACE,KAAK;GACH,mBAAmB,YAAY,UAAU;GACzC;EAGF,KAAK;GACH,sBAAsB,YAAY,UAAU;GAC5C;EAGF,KAAK;EACL,KAAK;GAGH,wBAAwB,YAAY,UAAU;GAC9C;EAGF,KAAK;GACH,0BAA0B,YAAY,UAAU;GAChD;EAGF,KAAK,QACH,kBAAkB,YAAY,UAAU;CAO5C;CAEA,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,WAAW,GACrC;CAGF,OAAO;AACT;AAEA,SAAS,mBACP,YACA,YACM;CACN,IAAI,MAAM,QAAQ,WAAW,KAAK,GAChC,WAAW,iBAAiB,WAAW,MAAM;CAG/C,IAAI,WAAW,OAAO,SAAS,QAC7B,WAAW,sBAAsB,WAAW,MAAM;CAGpD,IAAI,WAAW,OAAO,aAAa,QACjC,WAAW,0BAA0B,WAAW,MAAM;CAOxD,IAAI,WAAW,eAAe,QAC5B,WAAW,sBAAsB,WAAW;CAG9C,IAAI,WAAW,kBAAkB,QAC/B,WAAW,yBAAyB,WAAW;AAEnD;AAEA,SAAS,sBACP,YACA,YACM;CACN,IAAI,WAAW,iBAAiB,QAC9B,WAAW,mBAAmB,WAAW;CAG3C,IAAI,WAAW,cAAc,QAC3B,WAAW,wBAAwB,WAAW;CAGhD,IAAI,WAAW,UAAU,QACvB,WAAW,oBAAoB,OAAO,KAAK,WAAW,KAAK,CAAC,CAAC;AAEjE;AAEA,SAAS,wBACP,YACA,YACM;CACN,IAAI,WAAW,mBAAmB,QAChC,WAAW,qBAAqB,WAAW;CAG7C,IAAI,WAAW,iBAAiB,QAC9B,WAAW,6BAA6B,WAAW;CAGrD,IAAI,WAAW,eAAe,QAC5B,WAAW,2BAA2B,WAAW;AAErD;AAEA,SAAS,0BACP,YACA,YACM;CACN,IAAI,WAAW,cAAc,QAC3B,WAAW,4BAA4B,WAAW;CAGpD,IAAI,WAAW,cAAc,QAC3B,WAAW,4BAA4B,WAAW;CAGpD,IAAI,MAAM,QAAQ,WAAW,KAAK,GAChC,WAAW,wBAAwB,WAAW,MAAM;AAExD;AAEA,SAAS,kBACP,YACA,YACM;CACN,IAAI,WAAW,cAAc,QAC3B,WAAW,oBAAoB,WAAW;CAG5C,IAAI,WAAW,WAAW,QACxB,WAAW,iBAAiB,WAAW;CAGzC,IAAI,WAAW,kBAAkB,QAC/B,WAAW,wBAAwB,WAAW;AAElD"}

package/esm/collector/index.d.mts

@@ -3,4 +3,5 @@ import { CollectorOptions, ExporterErrorHandler, createCollector } from "./colle
 import { reportToTrace } from "./report-to-trace.mjs";
 import { reportToSpan } from "./report-to-span.mjs";
 import { extractSpanAttributes } from "./extract-span-attributes.mjs";
-import { normalizeError } from "./normalize-error.mjs";
+import { normalizeError } from "./normalize-error.mjs";
+export { type CollectorOptions, type ContentCaptureOptions, type ContentRedactor, type ExporterErrorHandler, createCollector, extractSpanAttributes, normalizeError, reportToSpan, reportToTrace };

package/esm/collector/index.mjs

@@ -4,4 +4,4 @@ import { reportToSpan } from "./report-to-span.mjs";
 import { reportToTrace } from "./report-to-trace.mjs";
 import { createCollector } from "./collector.mjs";
 
-export {  };
+export { createCollector, extractSpanAttributes, normalizeError, reportToSpan, reportToTrace };

package/esm/collector/normalize-error.d.mts

@@ -1,5 +1,4 @@
 import { TraceSpanError } from "../contracts/trace.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/collector/normalize-error.d.ts
 /**
  * Project a captured execution error onto the structural
@@ -21,7 +20,6 @@ import { TraceSpanError } from "../contracts/trace.type.mjs";
  * const spanError = normalizeError(report.error);
  * // { type: "RATE_LIMIT", message: "429 Too Many Requests", stack: "..." }
  */
-declare function normalizeError(error: unknown): TraceSpanError | undefined;
+export declare function normalizeError(error: unknown): TraceSpanError | undefined;
 //#endregion
-export { normalizeError };
 //# sourceMappingURL=normalize-error.d.mts.map

package/esm/collector/normalize-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-error.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/normalize-error.ts"],"mappings":";;;;;AAuBA;;;;AAA8D;;;;;;;;;;;;;;iBAA9C,cAAA,CAAe,KAAA,YAAiB,cAAc"}
+{"version":3,"file":"normalize-error.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/normalize-error.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;wBAuBgB,eAAe,iBAAiB"}

package/esm/collector/report-to-span.d.mts

@@ -1,7 +1,6 @@
 import { TraceSpan } from "../contracts/trace.type.mjs";
 import { ContentCaptureOptions } from "./content-capture.type.mjs";
 import { BaseReport } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/collector/report-to-span.d.ts
 /**
  * Project one {@link BaseReport} node — and its entire subtree — into a
@@ -32,7 +31,6 @@ import { BaseReport } from "@warlock.js/ai";
  * const root = reportToSpan(result.report);
  * console.log(root.spanId, root.traceId, root.children.length);
  */
-declare function reportToSpan(report: BaseReport, options?: ContentCaptureOptions): TraceSpan;
+export declare function reportToSpan(report: BaseReport, options?: ContentCaptureOptions): TraceSpan;
 //#endregion
-export { reportToSpan };
 //# sourceMappingURL=report-to-span.d.mts.map

package/esm/collector/report-to-span.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"report-to-span.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/report-to-span.ts"],"mappings":";;;;;;;AAmCA;;;;;;;;;;;;;;AAA4F;;;;;;;;;;;;;iBAA5E,YAAA,CAAa,MAAA,EAAQ,UAAA,EAAY,OAAA,GAAU,qBAAA,GAAwB,SAAA"}
+{"version":3,"file":"report-to-span.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/report-to-span.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmCgB,aAAa,QAAQ,YAAY,UAAU,wBAAwB"}

package/esm/collector/report-to-trace.d.mts

@@ -1,7 +1,6 @@
 import { Trace } from "../contracts/trace.type.mjs";
 import { ContentCaptureOptions } from "./content-capture.type.mjs";
 import { BaseReport } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/collector/report-to-trace.d.ts
 /**
  * Project an outermost {@link BaseReport} (one whole `.execute()` /
@@ -33,7 +32,6 @@ import { BaseReport } from "@warlock.js/ai";
  * const trace = reportToTrace(result.report, result.error);
  * console.log(trace.traceId, trace.usage.total, trace.duration);
  */
-declare function reportToTrace(report: BaseReport, rootError?: unknown, options?: ContentCaptureOptions): Trace;
+export declare function reportToTrace(report: BaseReport, rootError?: unknown, options?: ContentCaptureOptions): Trace;
 //#endregion
-export { reportToTrace };
 //# sourceMappingURL=report-to-trace.d.mts.map

package/esm/collector/report-to-trace.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"report-to-trace.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/report-to-trace.ts"],"mappings":";;;;;;;AAoCA;;;;;;;;;;;;;;;AAIQ;;;;;;;;;;;;;iBAJQ,aAAA,CACd,MAAA,EAAQ,UAAA,EACR,SAAA,YACA,OAAA,GAAU,qBAAA,GACT,KAAA"}
+{"version":3,"file":"report-to-trace.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/collector/report-to-trace.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoCgB,cACd,QAAQ,YACR,qBACA,UAAU,wBACT"}

package/esm/config/apply-panoptic-config.d.mts

@@ -1,5 +1,5 @@
+import "../dashboard/dashboard.type.mjs";
 import { PanopticConfig } from "./panoptic-config.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/config/apply-panoptic-config.d.ts
 /**
  * Read a {@link PanopticConfig} and wire panoptic onto the core observe
@@ -21,7 +21,6 @@ import { PanopticConfig } from "./panoptic-config.type.mjs";
  * one and a fresh store was created — primarily for tests; callers can
  * ignore it.
  */
-declare function applyPanopticConfig(config?: PanopticConfig): void;
+export declare function applyPanopticConfig(config?: PanopticConfig): void;
 //#endregion
-export { applyPanopticConfig };
 //# sourceMappingURL=apply-panoptic-config.d.mts.map

package/esm/config/apply-panoptic-config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-panoptic-config.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/config/apply-panoptic-config.ts"],"mappings":";;;;;AAiDA;;;;AAA2D;;;;;;;;;;;;;;iBAA3C,mBAAA,CAAoB,MAAuB,GAAd,cAAc"}
+{"version":3,"file":"apply-panoptic-config.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/config/apply-panoptic-config.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;wBAiDgB,oBAAoB,SAAS"}

package/esm/config/index.d.mts

@@ -1,2 +1,3 @@
 import { PanopticConfig } from "./panoptic-config.type.mjs";
-import { applyPanopticConfig } from "./apply-panoptic-config.mjs";
+import { applyPanopticConfig } from "./apply-panoptic-config.mjs";
+export { type PanopticConfig, applyPanopticConfig };

package/esm/config/index.mjs

@@ -1,3 +1,3 @@
 import { applyPanopticConfig } from "./apply-panoptic-config.mjs";
 
-export {  };
+export { applyPanopticConfig };

package/esm/config/panoptic-config.type.d.mts

@@ -1,7 +1,6 @@
 import { ExporterContract } from "../contracts/exporter.contract.mjs";
 import { CacheDriverInput } from "../store/cache-trace-store.mjs";
 import { DashboardOptions } from "../dashboard/dashboard.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/config/panoptic-config.type.d.ts
 /**
  * Declarative panoptic configuration, set once through the global
@@ -25,7 +24,7 @@ import { DashboardOptions } from "../dashboard/dashboard.type.mjs";
  *   },
  * });
  */
-type PanopticConfig = {
+export type PanopticConfig = {
   /**
    * Exporters the collector feeds (a store, OTel, Langfuse, …). A
    * {@link import("../store/in-memory-trace-store").createInMemoryTraceStore}
@@ -89,7 +88,6 @@ declare module "@warlock.js/ai" {
     /** Declarative panoptic observability config. See {@link PanopticConfig}. */
     panoptic?: PanopticConfig;
   }
-} //# sourceMappingURL=panoptic-config.type.d.ts.map
+}
 //#endregion
-export { PanopticConfig };
 //# sourceMappingURL=panoptic-config.type.d.mts.map

package/esm/config/panoptic-config.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"panoptic-config.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/config/panoptic-config.type.ts"],"mappings":";;;;;;;AA0BA;;;;;;;;;;;;;;;;;;;;KAAY,cAAA;EA0DV;;;;;;EAnDA,SAAA,GAAY,gBAAA;EA4De;;AAAA;;;;;;;;;;EA/C3B,KAAA,GAAQ,gBAAA;;;;;;;;EAQR,SAAA,aAAsB,gBAAA;;;;;;EAMtB,UAAA;;;;;;EAMA,cAAA;;;;;;EAMA,WAAA;;;;;;;;;;;EAWA,OAAA,IAAW,KAAA;AAAA;AAAA;EAAA,UAQD,QAAA;;IAER,QAAA,GAAW,cAAc;EAAA;AAAA"}
+{"version":3,"file":"panoptic-config.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/config/panoptic-config.type.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;YA0BY;;;;;;;EAOV,YAAY;;;;;;;;;;;;;EAaZ,QAAQ;;;;;;;;EAQR,sBAAsB;;;;;;EAMtB;;;;;;EAMA;;;;;;EAMA;;;;;;;;;;;EAWA,WAAW;;;YAQD;;IAER,WAAW"}

package/esm/contracts/collector.contract.d.mts

@@ -1,7 +1,6 @@
 import { Trace } from "./trace.type.mjs";
 import { ExporterContract } from "./exporter.contract.mjs";
 import { BaseReport } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/contracts/collector.contract.d.ts
 /**
  * Contract for the Panoptic collector — the source end of the
@@ -21,7 +20,7 @@ import { BaseReport } from "@warlock.js/ai";
  * // on shutdown:
  * await collector.shutdown();
  */
-interface CollectorContract {
+export interface CollectorContract {
   /**
    * Register an exporter. Returns the collector for chaining. Duplicate
    * registration (same `ExporterContract.name`) is ignored.
@@ -59,5 +58,4 @@ interface CollectorContract {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { CollectorContract };
 //# sourceMappingURL=collector.contract.d.mts.map

package/esm/contracts/collector.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/collector.contract.ts"],"mappings":";;;;;;;AAsBA;;;;;;;;;;;;;;;;UAAiB,iBAAA;EAmBP;;;;EAdR,GAAA,CAAI,QAAA,EAAU,gBAAA;EAsBN;;;;;;;;AAYW;;;;EApBnB,OAAA,CAAQ,MAAA,EAAQ,UAAA,EAAY,SAAA,aAAsB,OAAA;;;;;;;EAQlD,OAAA,CAAQ,MAAA,EAAQ,UAAA,EAAY,SAAA,aAAsB,KAAA;;;;;EAMlD,KAAA,IAAS,OAAA;;;;;EAMT,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"collector.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/collector.contract.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;iBAsBiB;;;;;EAKf,IAAI,UAAU;;;;;;;;;;;;;EAcd,QAAQ,QAAQ,YAAY,sBAAsB;;;;;;;EAQlD,QAAQ,QAAQ,YAAY,sBAAsB;;;;;EAMlD,SAAS;;;;;EAMT,YAAY"}

package/esm/contracts/exporter.contract.d.mts

@@ -1,5 +1,4 @@
 import { Trace, TraceSpan } from "./trace.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/contracts/exporter.contract.d.ts
 /**
  * Contract every Panoptic exporter implements. An exporter is the sink
@@ -35,7 +34,7 @@ import { Trace, TraceSpan } from "./trace.type.mjs";
  *   },
  * };
  */
-interface ExporterContract {
+export interface ExporterContract {
   /**
    * Stable identifier for this exporter (e.g. `"otel"`, `"langfuse"`,
    * `"console"`). Used in logs and to de-duplicate exporters registered
@@ -72,5 +71,4 @@ interface ExporterContract {
   shutdown?(): void | Promise<void>;
 }
 //#endregion
-export { ExporterContract };
 //# sourceMappingURL=exporter.contract.d.mts.map

package/esm/contracts/exporter.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/exporter.contract.ts"],"mappings":";;;;;AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;AAsC6B;;;;;;;UAtCZ,gBAAA;;;;;;WAMN,IAAA;;;;;;EAOT,MAAA,CAAO,KAAA,EAAO,KAAA,UAAe,OAAA;;;;;;;;;;EAW7B,UAAA,EAAY,IAAA,EAAM,SAAA,UAAmB,OAAA;;;;;;EAOrC,KAAA,YAAiB,OAAA;;;;;;EAOjB,QAAA,YAAoB,OAAA;AAAA"}
+{"version":3,"file":"exporter.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/exporter.contract.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCiB;;;;;;WAMN;;;;;;EAOT,OAAO,OAAO,eAAe;;;;;;;;;;EAW7B,YAAY,MAAM,mBAAmB;;;;;;EAOrC,iBAAiB;;;;;;EAOjB,oBAAoB"}

package/esm/contracts/index.d.mts

@@ -1,3 +1,4 @@
 import { Trace, TraceSpan, TraceSpanError } from "./trace.type.mjs";
 import { ExporterContract } from "./exporter.contract.mjs";
-import { CollectorContract } from "./collector.contract.mjs";
+import { CollectorContract } from "./collector.contract.mjs";
+export type { CollectorContract, ExporterContract, Trace, TraceSpan, TraceSpanError };

package/esm/contracts/trace.type.d.mts

@@ -1,5 +1,4 @@
 import { ReportStatus, ReportType, Usage } from "@warlock.js/ai";
-
 //#region ../../packages/ai-panoptic/src/contracts/trace.type.d.ts
 /**
  * A single node in a Panoptic trace tree, derived 1:1 from a core
@@ -31,7 +30,7 @@ import { ReportStatus, ReportType, Usage } from "@warlock.js/ai";
  *   children: [],
  * };
  */
-type TraceSpan = {
+export type TraceSpan = {
   /**
    * Stable id for this span. Mirrors `BaseReport.runId` — one span per
    * execution node.
@@ -54,19 +53,26 @@ type TraceSpan = {
    * Surfaces as a session/thread dimension in backends that model
    * conversations. Absent when the caller didn't supply one.
    */
-  sessionId?: string; /** Executable identity — the tool/agent/workflow/supervisor name. */
+  sessionId?: string;
+  /** Executable identity — the tool/agent/workflow/supervisor name. */
   name: string;
   /**
    * Dev-curated version string mirrored from `BaseReport.version`.
    * Free-form; surfaced as a span attribute so dashboards can slice
    * runs of "agent X v2.1" from "v2.2". Absent when undeclared.
    */
-  version?: string; /** Discriminator for the kind of executable that produced this span. */
-  type: ReportType; /** Terminal status of this execution, mirrored from `BaseReport.status`. */
-  status: ReportStatus; /** ISO-8601 wall-clock timestamp when execution began. */
-  startedAt: string; /** ISO-8601 wall-clock timestamp when execution finished. */
-  endedAt: string; /** Monotonic duration in milliseconds. */
-  duration: number; /** Rolled-up usage for this node (own cost + sum of children). */
+  version?: string;
+  /** Discriminator for the kind of executable that produced this span. */
+  type: ReportType;
+  /** Terminal status of this execution, mirrored from `BaseReport.status`. */
+  status: ReportStatus;
+  /** ISO-8601 wall-clock timestamp when execution began. */
+  startedAt: string;
+  /** ISO-8601 wall-clock timestamp when execution finished. */
+  endedAt: string;
+  /** Monotonic duration in milliseconds. */
+  duration: number;
+  /** Rolled-up usage for this node (own cost + sum of children). */
   usage: Usage;
   /**
    * Normalized error description when `status` is `"failed"` /
@@ -110,9 +116,12 @@ type TraceSpan = {
  * Kept structural (not an `Error` instance) so it survives JSON
  * serialization to a backend collector unchanged.
  */
-type TraceSpanError = {
-  /** Stable error identifier (typed framework error name when available). */type: string; /** Human-readable message — secret-scrubbed before storage (S4). */
-  message: string; /** Optional captured stack trace, secret-scrubbed when present (S4). */
+export type TraceSpanError = {
+  /** Stable error identifier (typed framework error name when available). */
+  type: string;
+  /** Human-readable message — secret-scrubbed before storage (S4). */
+  message: string;
+  /** Optional captured stack trace, secret-scrubbed when present (S4). */
   stack?: string;
   /**
    * Optional redacted view of the error's `cause` (S4) — a raw provider
@@ -128,13 +137,20 @@ type TraceSpanError = {
  * `Trace` corresponds to one outermost `BaseReport` (a single
  * `.execute()` / `.invoke()` call).
  */
-type Trace = {
-  /** Trace id — equals the root span's `traceId` / `rootRunId`. */traceId: string; /** Session grouping id, when the originating run carried one. */
-  sessionId?: string; /** Root span of this trace. */
-  root: TraceSpan; /** Wall-clock start of the trace (root span `startedAt`). */
-  startedAt: string; /** Wall-clock end of the trace (root span `endedAt`). */
-  endedAt: string; /** Total trace duration in milliseconds (root span `duration`). */
-  duration: number; /** Trace-wide usage rollup (root span `usage`). */
+export type Trace = {
+  /** Trace id — equals the root span's `traceId` / `rootRunId`. */
+  traceId: string;
+  /** Session grouping id, when the originating run carried one. */
+  sessionId?: string;
+  /** Root span of this trace. */
+  root: TraceSpan;
+  /** Wall-clock start of the trace (root span `startedAt`). */
+  startedAt: string;
+  /** Wall-clock end of the trace (root span `endedAt`). */
+  endedAt: string;
+  /** Total trace duration in milliseconds (root span `duration`). */
+  duration: number;
+  /** Trace-wide usage rollup (root span `usage`). */
   usage: Usage;
   /**
    * Wire-format version of the source `BaseReport` shape, mirrored from
@@ -144,5 +160,4 @@ type Trace = {
   reportSchemaVersion?: number;
 };
 //#endregion
-export { Trace, TraceSpan, TraceSpanError };
 //# sourceMappingURL=trace.type.d.mts.map

package/esm/contracts/trace.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/trace.type.ts"],"mappings":";;;;;AAgCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAY,SAAA;EA2DG;;;;EAtDb,MAAA;EA0EmB;AAAA;AAQrB;;EA7EE,YAAA;EA6EwB;;;;;;EAtExB,OAAA;EA4FU;;;;;EAtFV,SAAA,WA4FA;EA1FA,IAAA;EA4FA;;;;;EAtFA,OAAA,WAkGmB;EAhGnB,IAAA,EAAM,UAAA;EAEN,MAAA,EAAQ,YAAA;EAER,SAAA;EAEA,OAAA;EAEA,QAAA;EAEA,KAAA,EAAO,KAAA;;;;;;EAMP,KAAA,GAAQ,cAAA;;;;;;;;;;EAUR,UAAA,GAAa,MAAA;;;;;;;;EAQb,KAAA;;;;;;EAMA,MAAA;;;;;;EAMA,QAAA,EAAU,SAAA;AAAA;;;;;;KAQA,cAAA;6EAEV,IAAA;EAEA,OAAA;EAEA,KAAA;;;;;;;EAOA,KAAA;AAAA;;;;;;;KASU,KAAA;mEAEV,OAAA;EAEA,SAAA;EAEA,IAAA,EAAM,SAAA;EAEN,SAAA;EAEA,OAAA;EAEA,QAAA;EAEA,KAAA,EAAO,KAAK;;;;;;EAMZ,mBAAA;AAAA"}
+{"version":3,"file":"trace.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/contracts/trace.type.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAgCY;;;;;EAKV;;;;;EAKA;;;;;;;EAOA;;;;;;EAMA;;EAEA;;;;;;EAMA;;EAEA,MAAM;;EAEN,QAAQ;;EAER;;EAEA;;EAEA;;EAEA,OAAO;;;;;;EAMP,QAAQ;;;;;;;;;;EAUR,aAAa;;;;;;;;EAQb;;;;;;EAMA;;;;;;EAMA,UAAU;;;;;;;YAQA;;EAEV;;EAEA;;EAEA;;;;;;;EAOA;;;;;;;;YASU;;EAEV;;EAEA;;EAEA,MAAM;;EAEN;;EAEA;;EAEA;;EAEA,OAAO;;;;;;EAMP"}

package/esm/dashboard/dashboard.d.mts

@@ -1,6 +1,5 @@
 import { TraceStoreContract } from "../store/trace-store.contract.mjs";
 import { DashboardHandle, DashboardOptions } from "./dashboard.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/dashboard/dashboard.d.ts
 /**
  * Start the local Panoptic dashboard over a {@link TraceStoreContract} —
@@ -26,7 +25,6 @@ import { DashboardHandle, DashboardOptions } from "./dashboard.type.mjs";
  * // ...later:
  * await handle.close();
  */
-declare function dashboard(store: TraceStoreContract, options?: DashboardOptions): Promise<DashboardHandle>;
+export declare function dashboard(store: TraceStoreContract, options?: DashboardOptions): Promise<DashboardHandle>;
 //#endregion
-export { dashboard };
 //# sourceMappingURL=dashboard.d.mts.map

package/esm/dashboard/dashboard.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.ts"],"mappings":";;;;;;AAiCA;;;;;;;;;;;;;;;;AAG0B;;;;;;iBAHV,SAAA,CACd,KAAA,EAAO,kBAAA,EACP,OAAA,GAAS,gBAAA,GACR,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"dashboard.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiCgB,UACd,OAAO,oBACP,UAAS,mBACR,QAAQ"}

package/esm/dashboard/dashboard.mjs

@@ -36,13 +36,14 @@ function dashboard(store, options = {}) {
 	const basePath = normalizeBasePath(options.basePath);
 	if (!isLoopbackHost(host) && !options.authToken) return Promise.reject(/* @__PURE__ */ new Error(`Panoptic dashboard: binding to a non-loopback host ("${host}") requires an \`authToken\` (the dashboard exposes raw prompt content). Pass \`authToken\`, or bind to 127.0.0.1.`));
 	const allowedHosts = (options.allowedHosts ?? defaultAllowedHosts(host)).map((h) => h.toLowerCase());
-	const server = createServer(createRequestHandler(store, {
+	const handler = createRequestHandler(store, {
 		basePath,
 		title,
 		authToken: options.authToken,
 		allowedHosts,
 		evaluate: options.evaluate
-	}));
+	});
+	const server = createServer(handler);
 	return new Promise((resolve, reject) => {
 		const onError = (error) => {
 			server.off("error", onError);

package/esm/dashboard/dashboard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.mjs","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.ts"],"sourcesContent":["import { createServer } from \"node:http\";\nimport type { TraceStoreContract } from \"../store/trace-store.contract\";\nimport type { DashboardHandle, DashboardOptions } from \"./dashboard.type\";\nimport { createRequestHandler } from \"./serve\";\n\nconst DEFAULT_PORT = 4319;\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_TITLE = \"Panoptic\";\n\n/**\n * Start the local Panoptic dashboard over a {@link TraceStoreContract} —\n * a zero-dependency `node:http` server that serves a read-only JSON API\n * and one self-contained HTML page polling it. The store is the live\n * object the collector fills, so each poll reflects the latest completed\n * traces with no extra wiring.\n *\n * This is a low-level building block. The documented path is\n * `ai.config({ panoptic: { dashboard } })`, which constructs (or reuses)\n * the store and calls this for you. Use it directly only when you manage\n * the store yourself.\n *\n * Binds loopback-only by default (`127.0.0.1`) so prompt content is never\n * exposed to the LAN. Pass `port: 0` for an ephemeral port — the resolved\n * port comes back on the handle. A port already in use rejects with a\n * clear, actionable `Error` rather than the raw `EADDRINUSE`.\n *\n * @example\n * const store = createInMemoryTraceStore();\n * const handle = await dashboard(store, { port: 4319, open: true });\n * console.log(handle.url); // http://127.0.0.1:4319/\n * // ...later:\n * await handle.close();\n */\nexport function dashboard(\n  store: TraceStoreContract,\n  options: DashboardOptions = {},\n): Promise<DashboardHandle> {\n  const port = options.port ?? DEFAULT_PORT;\n  const host = options.host ?? DEFAULT_HOST;\n  const title = options.title ?? DEFAULT_TITLE;\n  const basePath = normalizeBasePath(options.basePath);\n\n  // Secure-by-default off loopback (S4): a non-loopback bind without an\n  // auth token would expose raw prompt content to the network, so refuse\n  // to start rather than silently exposing it.\n  if (!isLoopbackHost(host) && !options.authToken) {\n    return Promise.reject(\n      new Error(\n        `Panoptic dashboard: binding to a non-loopback host (\"${host}\") requires an \\`authToken\\` ` +\n          \"(the dashboard exposes raw prompt content). Pass `authToken`, or bind to 127.0.0.1.\",\n      ),\n    );\n  }\n\n  const allowedHosts = (options.allowedHosts ?? defaultAllowedHosts(host)).map((h) =>\n    h.toLowerCase(),\n  );\n\n  const handler = createRequestHandler(store, {\n    basePath,\n    title,\n    authToken: options.authToken,\n    allowedHosts,\n    evaluate: options.evaluate,\n  });\n  const server = createServer(handler);\n\n  return new Promise<DashboardHandle>((resolve, reject) => {\n    const onError = (error: NodeJS.ErrnoException): void => {\n      server.off(\"error\", onError);\n\n      if (error.code === \"EADDRINUSE\") {\n        reject(\n          new Error(\n            `Panoptic dashboard: port ${port} in use; pass { port: 0 } for an ephemeral port`,\n          ),\n        );\n\n        return;\n      }\n\n      reject(error);\n    };\n\n    server.on(\"error\", onError);\n\n    server.listen(port, host, () => {\n      server.off(\"error\", onError);\n\n      const address = server.address();\n      const resolvedPort = typeof address === \"object\" && address !== null ? address.port : port;\n      const url = `http://${host}:${resolvedPort}${basePath}`;\n\n      if (options.open) {\n        openBrowser(url);\n      }\n\n      resolve({\n        url,\n        port: resolvedPort,\n        close(): Promise<void> {\n          return new Promise<void>((closeResolve, closeReject) => {\n            server.close((closeError) => {\n              if (closeError) {\n                closeReject(closeError);\n\n                return;\n              }\n\n              closeResolve();\n            });\n          });\n        },\n      });\n    });\n  });\n}\n\n/** Loopback hosts the dashboard may bind without an auth token. */\nfunction isLoopbackHost(host: string): boolean {\n  const h = host.toLowerCase();\n  return h === \"127.0.0.1\" || h === \"::1\" || h === \"[::1]\" || h === \"localhost\";\n}\n\n/**\n * Default `Host` allowlist for a given bind host. A loopback bind accepts\n * the loopback names a browser would send; a non-loopback bind defaults to\n * just the bound host (callers can widen via `allowedHosts`).\n */\nfunction defaultAllowedHosts(host: string): string[] {\n  if (isLoopbackHost(host)) {\n    return [\"localhost\", \"127.0.0.1\", \"[::1]\", \"::1\"];\n  }\n  return [host];\n}\n\n/**\n * Normalize a caller `basePath` to a leading-and-trailing-slash form the\n * router can prefix routes with. `undefined` / `\"\"` → `\"/\"`.\n */\nfunction normalizeBasePath(basePath?: string): string {\n  if (basePath === undefined || basePath.length === 0 || basePath === \"/\") {\n    return \"/\";\n  }\n\n  const withLeading = basePath.startsWith(\"/\") ? basePath : `/${basePath}`;\n\n  return withLeading.endsWith(\"/\") ? withLeading : `${withLeading}/`;\n}\n\n/**\n * Best-effort open of the default browser at `url`. Fire-and-forget and\n * fully swallowed — failing to open a browser must never reject the\n * dashboard start. Uses the platform's native opener via a lazy\n * `node:child_process` import so the dependency is paid only when\n * `open: true`.\n */\nfunction openBrowser(url: string): void {\n  void import(\"node:child_process\")\n    .then(({ spawn }) => {\n      const command =\n        process.platform === \"win32\" ? \"cmd\" : process.platform === \"darwin\" ? \"open\" : \"xdg-open\";\n      const args = process.platform === \"win32\" ? [\"/c\", \"start\", \"\", url] : [url];\n\n      const child = spawn(command, args, { stdio: \"ignore\", detached: true });\n      child.on(\"error\", () => {\n        // Swallow — opening a browser is best-effort.\n      });\n      child.unref();\n    })\n    .catch(() => {\n      // Swallow — opening a browser is best-effort.\n    });\n}\n"],"mappings":";;;;AAKA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;AA0BtB,SAAgB,UACd,OACA,UAA4B,CAAC,GACH;CAC1B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,WAAW,kBAAkB,QAAQ,QAAQ;CAKnD,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,QAAQ,WACpC,OAAO,QAAQ,uBACb,IAAI,MACF,wDAAwD,KAAK,mHAE/D,CACF;CAGF,MAAM,gBAAgB,QAAQ,gBAAgB,oBAAoB,IAAI,EAAC,CAAE,KAAK,MAC5E,EAAE,YAAY,CAChB;CASA,MAAM,SAAS,aAPC,qBAAqB,OAAO;EAC1C;EACA;EACA,WAAW,QAAQ;EACnB;EACA,UAAU,QAAQ;CACpB,CACkC,CAAC;CAEnC,OAAO,IAAI,SAA0B,SAAS,WAAW;EACvD,MAAM,WAAW,UAAuC;GACtD,OAAO,IAAI,SAAS,OAAO;GAE3B,IAAI,MAAM,SAAS,cAAc;IAC/B,uBACE,IAAI,MACF,4BAA4B,KAAK,gDACnC,CACF;IAEA;GACF;GAEA,OAAO,KAAK;EACd;EAEA,OAAO,GAAG,SAAS,OAAO;EAE1B,OAAO,OAAO,MAAM,YAAY;GAC9B,OAAO,IAAI,SAAS,OAAO;GAE3B,MAAM,UAAU,OAAO,QAAQ;GAC/B,MAAM,eAAe,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO;GACtF,MAAM,MAAM,UAAU,KAAK,GAAG,eAAe;GAE7C,IAAI,QAAQ,MACV,YAAY,GAAG;GAGjB,QAAQ;IACN;IACA,MAAM;IACN,QAAuB;KACrB,OAAO,IAAI,SAAe,cAAc,gBAAgB;MACtD,OAAO,OAAO,eAAe;OAC3B,IAAI,YAAY;QACd,YAAY,UAAU;QAEtB;OACF;OAEA,aAAa;MACf,CAAC;KACH,CAAC;IACH;GACF,CAAC;EACH,CAAC;CACH,CAAC;AACH;;AAGA,SAAS,eAAe,MAAuB;CAC7C,MAAM,IAAI,KAAK,YAAY;CAC3B,OAAO,MAAM,eAAe,MAAM,SAAS,MAAM,WAAW,MAAM;AACpE;;;;;;AAOA,SAAS,oBAAoB,MAAwB;CACnD,IAAI,eAAe,IAAI,GACrB,OAAO;EAAC;EAAa;EAAa;EAAS;CAAK;CAElD,OAAO,CAAC,IAAI;AACd;;;;;AAMA,SAAS,kBAAkB,UAA2B;CACpD,IAAI,aAAa,UAAa,SAAS,WAAW,KAAK,aAAa,KAClE,OAAO;CAGT,MAAM,cAAc,SAAS,WAAW,GAAG,IAAI,WAAW,IAAI;CAE9D,OAAO,YAAY,SAAS,GAAG,IAAI,cAAc,GAAG,YAAY;AAClE;;;;;;;;AASA,SAAS,YAAY,KAAmB;CACtC,AAAK,OAAO,qBAAqB,CAC9B,MAAM,EAAE,YAAY;EAKnB,MAAM,QAAQ,MAHZ,QAAQ,aAAa,UAAU,QAAQ,QAAQ,aAAa,WAAW,SAAS,YACrE,QAAQ,aAAa,UAAU;GAAC;GAAM;GAAS;GAAI;EAAG,IAAI,CAAC,GAAG,GAExC;GAAE,OAAO;GAAU,UAAU;EAAK,CAAC;EACtE,MAAM,GAAG,eAAe,CAExB,CAAC;EACD,MAAM,MAAM;CACd,CAAC,CAAC,CACD,YAAY,CAEb,CAAC;AACL"}
+{"version":3,"file":"dashboard.mjs","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.ts"],"sourcesContent":["import { createServer } from \"node:http\";\nimport type { TraceStoreContract } from \"../store/trace-store.contract\";\nimport type { DashboardHandle, DashboardOptions } from \"./dashboard.type\";\nimport { createRequestHandler } from \"./serve\";\n\nconst DEFAULT_PORT = 4319;\nconst DEFAULT_HOST = \"127.0.0.1\";\nconst DEFAULT_TITLE = \"Panoptic\";\n\n/**\n * Start the local Panoptic dashboard over a {@link TraceStoreContract} —\n * a zero-dependency `node:http` server that serves a read-only JSON API\n * and one self-contained HTML page polling it. The store is the live\n * object the collector fills, so each poll reflects the latest completed\n * traces with no extra wiring.\n *\n * This is a low-level building block. The documented path is\n * `ai.config({ panoptic: { dashboard } })`, which constructs (or reuses)\n * the store and calls this for you. Use it directly only when you manage\n * the store yourself.\n *\n * Binds loopback-only by default (`127.0.0.1`) so prompt content is never\n * exposed to the LAN. Pass `port: 0` for an ephemeral port — the resolved\n * port comes back on the handle. A port already in use rejects with a\n * clear, actionable `Error` rather than the raw `EADDRINUSE`.\n *\n * @example\n * const store = createInMemoryTraceStore();\n * const handle = await dashboard(store, { port: 4319, open: true });\n * console.log(handle.url); // http://127.0.0.1:4319/\n * // ...later:\n * await handle.close();\n */\nexport function dashboard(\n  store: TraceStoreContract,\n  options: DashboardOptions = {},\n): Promise<DashboardHandle> {\n  const port = options.port ?? DEFAULT_PORT;\n  const host = options.host ?? DEFAULT_HOST;\n  const title = options.title ?? DEFAULT_TITLE;\n  const basePath = normalizeBasePath(options.basePath);\n\n  // Secure-by-default off loopback (S4): a non-loopback bind without an\n  // auth token would expose raw prompt content to the network, so refuse\n  // to start rather than silently exposing it.\n  if (!isLoopbackHost(host) && !options.authToken) {\n    return Promise.reject(\n      new Error(\n        `Panoptic dashboard: binding to a non-loopback host (\"${host}\") requires an \\`authToken\\` ` +\n          \"(the dashboard exposes raw prompt content). Pass `authToken`, or bind to 127.0.0.1.\",\n      ),\n    );\n  }\n\n  const allowedHosts = (options.allowedHosts ?? defaultAllowedHosts(host)).map((h) =>\n    h.toLowerCase(),\n  );\n\n  const handler = createRequestHandler(store, {\n    basePath,\n    title,\n    authToken: options.authToken,\n    allowedHosts,\n    evaluate: options.evaluate,\n  });\n  const server = createServer(handler);\n\n  return new Promise<DashboardHandle>((resolve, reject) => {\n    const onError = (error: NodeJS.ErrnoException): void => {\n      server.off(\"error\", onError);\n\n      if (error.code === \"EADDRINUSE\") {\n        reject(\n          new Error(\n            `Panoptic dashboard: port ${port} in use; pass { port: 0 } for an ephemeral port`,\n          ),\n        );\n\n        return;\n      }\n\n      reject(error);\n    };\n\n    server.on(\"error\", onError);\n\n    server.listen(port, host, () => {\n      server.off(\"error\", onError);\n\n      const address = server.address();\n      const resolvedPort = typeof address === \"object\" && address !== null ? address.port : port;\n      const url = `http://${host}:${resolvedPort}${basePath}`;\n\n      if (options.open) {\n        openBrowser(url);\n      }\n\n      resolve({\n        url,\n        port: resolvedPort,\n        close(): Promise<void> {\n          return new Promise<void>((closeResolve, closeReject) => {\n            server.close((closeError) => {\n              if (closeError) {\n                closeReject(closeError);\n\n                return;\n              }\n\n              closeResolve();\n            });\n          });\n        },\n      });\n    });\n  });\n}\n\n/** Loopback hosts the dashboard may bind without an auth token. */\nfunction isLoopbackHost(host: string): boolean {\n  const h = host.toLowerCase();\n  return h === \"127.0.0.1\" || h === \"::1\" || h === \"[::1]\" || h === \"localhost\";\n}\n\n/**\n * Default `Host` allowlist for a given bind host. A loopback bind accepts\n * the loopback names a browser would send; a non-loopback bind defaults to\n * just the bound host (callers can widen via `allowedHosts`).\n */\nfunction defaultAllowedHosts(host: string): string[] {\n  if (isLoopbackHost(host)) {\n    return [\"localhost\", \"127.0.0.1\", \"[::1]\", \"::1\"];\n  }\n  return [host];\n}\n\n/**\n * Normalize a caller `basePath` to a leading-and-trailing-slash form the\n * router can prefix routes with. `undefined` / `\"\"` → `\"/\"`.\n */\nfunction normalizeBasePath(basePath?: string): string {\n  if (basePath === undefined || basePath.length === 0 || basePath === \"/\") {\n    return \"/\";\n  }\n\n  const withLeading = basePath.startsWith(\"/\") ? basePath : `/${basePath}`;\n\n  return withLeading.endsWith(\"/\") ? withLeading : `${withLeading}/`;\n}\n\n/**\n * Best-effort open of the default browser at `url`. Fire-and-forget and\n * fully swallowed — failing to open a browser must never reject the\n * dashboard start. Uses the platform's native opener via a lazy\n * `node:child_process` import so the dependency is paid only when\n * `open: true`.\n */\nfunction openBrowser(url: string): void {\n  void import(\"node:child_process\")\n    .then(({ spawn }) => {\n      const command =\n        process.platform === \"win32\" ? \"cmd\" : process.platform === \"darwin\" ? \"open\" : \"xdg-open\";\n      const args = process.platform === \"win32\" ? [\"/c\", \"start\", \"\", url] : [url];\n\n      const child = spawn(command, args, { stdio: \"ignore\", detached: true });\n      child.on(\"error\", () => {\n        // Swallow — opening a browser is best-effort.\n      });\n      child.unref();\n    })\n    .catch(() => {\n      // Swallow — opening a browser is best-effort.\n    });\n}\n"],"mappings":";;;;AAKA,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;AA0BtB,SAAgB,UACd,OACA,UAA4B,CAAC,GACH;CAC1B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,WAAW,kBAAkB,QAAQ,QAAQ;CAKnD,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,QAAQ,WACpC,OAAO,QAAQ,uBACb,IAAI,MACF,wDAAwD,KAAK,mHAE/D,CACF;CAGF,MAAM,gBAAgB,QAAQ,gBAAgB,oBAAoB,IAAI,EAAC,CAAE,KAAK,MAC5E,EAAE,YAAY,CAChB;CAEA,MAAM,UAAU,qBAAqB,OAAO;EAC1C;EACA;EACA,WAAW,QAAQ;EACnB;EACA,UAAU,QAAQ;CACpB,CAAC;CACD,MAAM,SAAS,aAAa,OAAO;CAEnC,OAAO,IAAI,SAA0B,SAAS,WAAW;EACvD,MAAM,WAAW,UAAuC;GACtD,OAAO,IAAI,SAAS,OAAO;GAE3B,IAAI,MAAM,SAAS,cAAc;IAC/B,uBACE,IAAI,MACF,4BAA4B,KAAK,gDACnC,CACF;IAEA;GACF;GAEA,OAAO,KAAK;EACd;EAEA,OAAO,GAAG,SAAS,OAAO;EAE1B,OAAO,OAAO,MAAM,YAAY;GAC9B,OAAO,IAAI,SAAS,OAAO;GAE3B,MAAM,UAAU,OAAO,QAAQ;GAC/B,MAAM,eAAe,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO;GACtF,MAAM,MAAM,UAAU,KAAK,GAAG,eAAe;GAE7C,IAAI,QAAQ,MACV,YAAY,GAAG;GAGjB,QAAQ;IACN;IACA,MAAM;IACN,QAAuB;KACrB,OAAO,IAAI,SAAe,cAAc,gBAAgB;MACtD,OAAO,OAAO,eAAe;OAC3B,IAAI,YAAY;QACd,YAAY,UAAU;QAEtB;OACF;OAEA,aAAa;MACf,CAAC;KACH,CAAC;IACH;GACF,CAAC;EACH,CAAC;CACH,CAAC;AACH;;AAGA,SAAS,eAAe,MAAuB;CAC7C,MAAM,IAAI,KAAK,YAAY;CAC3B,OAAO,MAAM,eAAe,MAAM,SAAS,MAAM,WAAW,MAAM;AACpE;;;;;;AAOA,SAAS,oBAAoB,MAAwB;CACnD,IAAI,eAAe,IAAI,GACrB,OAAO;EAAC;EAAa;EAAa;EAAS;CAAK;CAElD,OAAO,CAAC,IAAI;AACd;;;;;AAMA,SAAS,kBAAkB,UAA2B;CACpD,IAAI,aAAa,UAAa,SAAS,WAAW,KAAK,aAAa,KAClE,OAAO;CAGT,MAAM,cAAc,SAAS,WAAW,GAAG,IAAI,WAAW,IAAI;CAE9D,OAAO,YAAY,SAAS,GAAG,IAAI,cAAc,GAAG,YAAY;AAClE;;;;;;;;AASA,SAAS,YAAY,KAAmB;CACtC,AAAK,OAAO,qBAAqB,CAC9B,MAAM,EAAE,YAAY;EAKnB,MAAM,QAAQ,MAHZ,QAAQ,aAAa,UAAU,QAAQ,QAAQ,aAAa,WAAW,SAAS,YACrE,QAAQ,aAAa,UAAU;GAAC;GAAM;GAAS;GAAI;EAAG,IAAI,CAAC,GAAG,GAExC;GAAE,OAAO;GAAU,UAAU;EAAK,CAAC;EACtE,MAAM,GAAG,eAAe,CAExB,CAAC;EACD,MAAM,MAAM;CACd,CAAC,CAAC,CACD,YAAY,CAEb,CAAC;AACL"}

package/esm/dashboard/dashboard.type.d.mts

@@ -1,5 +1,4 @@
 import { EvaluateConfig } from "../evaluate/evaluate.type.mjs";
-
 //#region ../../packages/ai-panoptic/src/dashboard/dashboard.type.d.ts
 /**
  * Options for the local Panoptic {@link dashboard} server.
@@ -12,7 +11,7 @@ import { EvaluateConfig } from "../evaluate/evaluate.type.mjs";
  * {@link DashboardOptions.evaluate} enables. There is no auth or persistence
  * by default either.
  */
-type DashboardOptions = {
+export type DashboardOptions = {
   /**
    * TCP port to listen on. Default `4319`. Pass `0` for an ephemeral
    * port — the OS-assigned port is then returned on
@@ -35,7 +34,8 @@ type DashboardOptions = {
    * Open the default browser at the resolved URL once the server is
    * listening. Default `false`.
    */
-  open?: boolean; /** Title shown in the dashboard header. Default `"Panoptic"`. */
+  open?: boolean;
+  /** Title shown in the dashboard header. Default `"Panoptic"`. */
   title?: string;
   /**
    * Bearer token required on every request (S4). When set, a request must
@@ -66,11 +66,13 @@ type DashboardOptions = {
  * Carries the resolved URL + port (useful when `port: 0` requested an
  * ephemeral one) and a `close()` to release the port.
  */
-type DashboardHandle = {
-  /** Resolved URL the UI is served at (`http://host:port{basePath}`). */readonly url: string; /** Resolved port — the real OS-assigned port when `port: 0` was passed. */
-  readonly port: number; /** Stop the server and release the port. Resolves once fully closed. */
+export type DashboardHandle = {
+  /** Resolved URL the UI is served at (`http://host:port{basePath}`). */
+  readonly url: string;
+  /** Resolved port — the real OS-assigned port when `port: 0` was passed. */
+  readonly port: number;
+  /** Stop the server and release the port. Resolves once fully closed. */
   close(): Promise<void>;
 };
 //#endregion
-export { DashboardHandle, DashboardOptions };
 //# sourceMappingURL=dashboard.type.d.mts.map

package/esm/dashboard/dashboard.type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.type.ts"],"mappings":";;;;;AAaA;;;;;;;;;KAAY,gBAAA;EAuCV;;;;AASyB;EA1CzB,IAAA;EAkDyB;;;;;EA5CzB,IAAA;EAkDS;;AAAO;;;EA5ChB,QAAA;;;;;EAKA,IAAA;EAEA,KAAA;;;;;;;EAOA,SAAA;;;;;;;EAOA,YAAA;;;;;;;;;EASA,QAAA,GAAW,cAAc;AAAA;;;;;;KAQf,eAAA;kFAED,GAAA;WAEA,IAAA;EAET,KAAA,IAAS,OAAO;AAAA"}
+{"version":3,"file":"dashboard.type.d.mts","names":[],"sources":["../../../../../../../../packages/ai-panoptic/src/dashboard/dashboard.type.ts"],"mappings":";;;;;;;;;;;;;YAaY;;;;;;EAMV;;;;;;EAMA;;;;;;EAMA;;;;;EAKA;;EAEA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;;;EASA,WAAW;;;;;;;YAQD;;WAED;;WAEA;;EAET,SAAS"}

package/esm/dashboard/index.d.mts

@@ -1,3 +1,6 @@
 import { DashboardHandle, DashboardOptions } from "./dashboard.type.mjs";
 import { dashboard } from "./dashboard.mjs";
-import { NO_PROMPT_KEY, NO_SESSION_KEY, NO_TYPE_KEY, PromptGroup, SessionGroup, TraceFilter, TypeGroup, TypeStat, aggregateByType, filterTraces, groupByPrompt, groupBySession, groupByType, heatIntensity, matchesFilter, maxNodeCost, percentile, rollupCost, traceCost, tracePromptKey } from "./trace-filter.mjs";
+import "./serve.mjs";
+import "./parse-query.mjs";
+import { NO_PROMPT_KEY, NO_SESSION_KEY, NO_TYPE_KEY, PromptGroup, SessionGroup, TraceFilter, TypeGroup, TypeStat, aggregateByType, filterTraces, groupByPrompt, groupBySession, groupByType, heatIntensity, matchesFilter, maxNodeCost, percentile, rollupCost, traceCost, tracePromptKey } from "./trace-filter.mjs";
+export { type DashboardHandle, type DashboardOptions, dashboard };