@tangle-network/sdk-telemetry 0.60.78-develop.20261026103900.8d71e95 → 0.60.78-develop.20261026111948.bd9ddcb

package/README.md

@@ -3,6 +3,8 @@
 Usage tracking, credit management, execution-trace collection, and telemetry
 export for the Agent Dev Container SDK.
 
+The existing `server-timing` entry exports `partitionLifecycleWalls` for per-input accounting; `stage-span` exports parent, leaf and stage-tree projections. [Lifecycle accounting](src/lifecycle-wall.ts) preserves unavailable timings and signed overlap residuals. Consumers own population grouping, statistics and display labels.
+
 ## LLM call capture
 
 Capture LLM calls (model, tokens, latency, prompt/completion) with

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { f as parseServerTiming, l as ServerTimingEntry } from "./server-timing-BScGLvfx.mjs";
+import { f as parseServerTiming, l as ServerTimingEntry } from "./server-timing-CE4vurML.mjs";
 import { LifecycleOp, ORCHESTRATOR_HOP_ID_HEADER, PROVISION_TRACE_ID_HEADER, PTID_PREFIX, RecordOptions, SpanComponent, SpanRecorder, SpanStatus, StageSpan, StageSpanInput, isAdoptablePtid, mintPtid, monotonicNs, readOrMintPtid, spanDurationMs } from "./stage-span.mjs";
 import { AgentEvent, ErrorEvent as AgentErrorEvent, FilePart, GEN_AI_CONVERSATION_ID, GEN_AI_INPUT_TOKEN_KEYS, GEN_AI_MODEL_KEYS, GEN_AI_OPERATION_NAME, GEN_AI_OUTPUT_TOKEN_KEYS, GEN_AI_REQUEST_MODEL, GEN_AI_RESPONSE_MODEL, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, GenAiUsage, MessagePartUpdatedEvent, MessagePartUpdatedEvent as MessagePartUpdatedEvent$1, ParsedSSEEvent, Part, ReasoningPart, ResultEvent, SSEChunkParser, SSEEventData, SSEEventData as SSEEventData$1, SSEParserOptions, StatusEvent, StreamTokenUsage, StreamUsageAccumulator, StreamUsageExtractor, TOKEN_USAGE_COST_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, TextPart, TokenUsageCounts, ToolPart, ToolState, addTokenUsage, consumeSSEStream, createStreamUsageExtractor, createUsageCallback, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, isFilePart, isReasoningPart, isTextPart, isToolPart, parseSSEData as parseSSEData$1, parseSSEStream, readTokenCostUsd, readTokenUsage, tokenCount, tokenUsageSource } from "@tangle-network/agent-core";
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { c as parseServerTiming } from "./server-timing-CTGu_pos.mjs";
+import { c as parseServerTiming } from "./server-timing-HI-hXI39.mjs";
 import { ORCHESTRATOR_HOP_ID_HEADER, PROVISION_TRACE_ID_HEADER, PTID_PREFIX, SpanRecorder, isAdoptablePtid, mintPtid, monotonicNs, readOrMintPtid, spanDurationMs } from "./stage-span.mjs";
 import { GEN_AI_CONVERSATION_ID, GEN_AI_CONVERSATION_ID as GEN_AI_CONVERSATION_ID$1, GEN_AI_INPUT_TOKEN_KEYS, GEN_AI_MODEL_KEYS, GEN_AI_OPERATION_NAME, GEN_AI_OPERATION_NAME as GEN_AI_OPERATION_NAME$1, GEN_AI_OUTPUT_TOKEN_KEYS, GEN_AI_REQUEST_MODEL, GEN_AI_REQUEST_MODEL as GEN_AI_REQUEST_MODEL$1, GEN_AI_RESPONSE_MODEL, GEN_AI_RESPONSE_MODEL as GEN_AI_RESPONSE_MODEL$1, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_INPUT_TOKENS as GEN_AI_USAGE_INPUT_TOKENS$1, GEN_AI_USAGE_OUTPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS as GEN_AI_USAGE_OUTPUT_TOKENS$1, SSEChunkParser, StreamUsageExtractor, TOKEN_USAGE_COST_KEYS, TOKEN_USAGE_INPUT_KEYS, TOKEN_USAGE_OUTPUT_KEYS, addTokenUsage, consumeSSEStream, createStreamUsageExtractor, createUsageCallback, firstTokenCount, firstUsageCostUsd, genAiUsageAttributes, isFilePart, isReasoningPart, isTextPart, isToolPart, parseSSEData as parseSSEData$1, parseSSEStream, readTokenCostUsd, readTokenUsage, tokenCount, tokenUsageSource } from "@tangle-network/agent-core";
 //#region src/enrichment/parse.ts

package/dist/server-timing-CE4vurML.d.mts

@@ -0,0 +1,235 @@
+//#region src/lifecycle-wall.d.ts
+/**
+ * Per-flow shape of the accounting window. `totalOperation` is the span whose
+ * wall the named leaves must tile; `postReadyOperations` run AFTER it is
+ * stamped (excluded from the leaf sum); `prepUmbrella` is the optional
+ * create-style split of an entry umbrella minus its measured leaf children. Absent
+ * `prepUmbrella` ⇒ `prepUnaccountedMs` is always 0 and the whole dark falls
+ * into `unaccountedMs` (the shape every non-create flow uses).
+ */
+type FlowAccountingSpec = {
+  totalOperation: string;
+  postReadyOperations?: ReadonlySet<string>;
+  prepUmbrella?: {
+    operation: string;
+  };
+};
+declare const CREATE_ACCOUNTING_SPEC: FlowAccountingSpec;
+declare const RESUME_ACCOUNTING_SPEC: FlowAccountingSpec;
+declare const STOP_ACCOUNTING_SPEC: FlowAccountingSpec;
+declare const DELETE_ACCOUNTING_SPEC: FlowAccountingSpec;
+interface LifecycleStageTiming {
+  operation: string;
+  durationMs?: number;
+  parent?: string | null;
+}
+type Values = Readonly<Record<string, number>>;
+interface LifecycleWallSample {
+  wallMs: number;
+  httpMs: number;
+  hops?: Values;
+  spanOps?: readonly LifecycleStageTiming[];
+  spanLeaves?: Values;
+  spanTotalMs?: number | null;
+  orchStages?: Values | null;
+  jobPhases?: Values | null;
+  jobMs?: number | null;
+  settleMs?: number | null;
+  spanAccountedMs?: number;
+}
+interface LifecycleWallFlow extends Partial<FlowAccountingSpec> {
+  workerTotalHop: string;
+  addPreHandler: boolean;
+  settleHop?: string;
+  workerNamedHops?: readonly string[];
+}
+/**
+ * A flat `{name: ms}` ledger read as the tree its names describe.
+ *
+ * Every producer in this repo emits nested stages FLAT, with the containment
+ * in the name: `capture.<hostPhase>` and `capture.restic_<phase>` inside
+ * `capture` (snapshot-helpers.ts), `materialize.parentRead|precreate|
+ * branchComplete|host.*|child.*|residual` inside `materialize` (branch.ts),
+ * `delete.<hostPhase>` inside `delete` and `restore_workspace.<phase>` inside
+ * `restore_workspace` (snapshots.ts). Summing every entry as a sibling counts
+ * the children inside their parent a second time and reports a wall the
+ * orchestrator never spent.
+ *
+ * So a dotted name is NEVER top-level. It attaches to the longest prefix that
+ * exists as a stage; when no prefix exists — the restore job's `host.<phase>`,
+ * which the queue records inside `restore_workspace` without naming it
+ * (snapshot-job-queue.ts:394) — it is still excluded from the top-level sum
+ * and reported as a child of the ledger at large. Excluding it can only leave
+ * MORE time unnamed, never fabricate a reconciliation.
+ */
+declare function stageTree(stages: Readonly<Record<string, number>>): {
+  nodes: {
+    name: string;
+    ms: number;
+    parent: string | null;
+  }[];
+  topLevel: {
+    name: string;
+    ms: number;
+    parent: string | null;
+  }[]; /** Children whose declared parent is not in the ledger; never summed. */
+  orphans: {
+    name: string;
+    ms: number;
+    parent: string | null;
+  }[];
+  topLevelMs: number;
+};
+/** Parent operations contain their descendants and are never counted as leaves. */
+declare function parentOperations(operations: readonly LifecycleStageTiming[]): ReadonlySet<string>;
+/**
+ * The measured leaves of one response's span tree, per the flow's own spec.
+ *
+ * Identical rule to the orchestrator's `computeFlowAccountingResiduals`: drop
+ * the total span (it is the window), drop the spans stamped after it closes,
+ * and drop any span another span names as its parent (a parent re-measures its
+ * children). What is left sums to the window minus its named residual.
+ */
+declare function leafOperations<T extends LifecycleStageTiming>(operations: readonly T[], excluded?: ReadonlySet<string>, parents?: ReadonlySet<string>): (T & {
+  durationMs: number;
+})[];
+declare function operationLeafDurations(operations: readonly LifecycleStageTiming[], excluded?: ReadonlySet<string>): Map<string, number>;
+/**
+ * Partition one input before aggregation: null is unavailable; a negative
+ * residual is overlapping evidence, never an instruction to publish zero.
+ * Callers retain their population grouping, medians and display labels.
+ */
+declare function partitionLifecycleWalls(sample: LifecycleWallSample, flow: LifecycleWallFlow): {
+  wallMs: number;
+  httpMs: number;
+  workerWallMs: number | null;
+  roundTripMs: number | null;
+  orchServerMs: number | null;
+  orchIncludesTransport: boolean;
+  workerIncludesTransport: boolean;
+  terms: {
+    edge: number | null;
+    worker: number | null;
+    transport: number | null;
+    orch: number | null;
+    job: number | null;
+    settle: number | null;
+    dark: number;
+  };
+  workerUnattributedMs: number | null;
+  orchUnattributedMs: number | null;
+  jobUnattributedMs: number | null;
+  unnamedMs: number;
+  unnamedShare: number;
+  overcountMs: number;
+  spanLeaves: {
+    [k: string]: number;
+  };
+  workerStages: {
+    [k: string]: number;
+  };
+  orchTree: {
+    nodes: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[];
+    topLevel: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[]; /** Children whose declared parent is not in the ledger; never summed. */
+    orphans: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[];
+    topLevelMs: number;
+  };
+  jobTree: {
+    nodes: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[];
+    topLevel: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[]; /** Children whose declared parent is not in the ledger; never summed. */
+    orphans: {
+      name: string;
+      ms: number;
+      parent: string | null;
+    }[];
+    topLevelMs: number;
+  };
+  spanTotalMs: number | null;
+  window: {
+    transportMs: number | null;
+    afterSpanMs: number | null;
+    outerMs: number | null;
+    workerUnattributedMs: number | null;
+    workerOwnMs: number | null;
+    gaps: {
+      overlapMs: number;
+      underTileMs: number;
+      workerOverlapMs: number;
+      unrowedMs: number;
+      clampedMs: number;
+    };
+  };
+};
+//#endregion
+//#region src/create-wall.d.ts
+/** Exclusive create-request wall phases; nested service spans are a separate view. */
+declare const CREATE_WALL_PHASES: readonly ["middleware", "identity", "preflight", "tenantCoordination", "configuration", "leaseSelection", "credentialJournal", "quotaReservation", "orchestrator", "provisionResponse", "responseBody", "credentialAllocation", "postCreate", "response"];
+type CreateWallPhase = (typeof CREATE_WALL_PHASES)[number];
+type CreateWallPhases = Record<CreateWallPhase, number>;
+interface CreateWallMeasurement {
+  phases: CreateWallPhases;
+  totalMs: number;
+  /** Includes middleware/auth, preserving the original bookkeeping + post budget. */
+  bookkeepingPostCreateMs: number;
+}
+/** The original other-Worker + post-create budget, including auth/middleware. */
+declare function createBookkeepingPostWall(phases: CreateWallPhases): number;
+/**
+ * One cursor owned by the sequential request path. Parallel operations keep
+ * their own spans and never transition this cursor from their callbacks.
+ * Invalid clocks or missing caller hooks withhold a complete measurement.
+ */
+declare function createWallTiming(startedAt: number): {
+  phase(name: CreateWallPhase, at: number): void;
+  finish(receivedAt: number, respondedAt: number): CreateWallMeasurement | null;
+};
+/** Read the already-parsed header. Historical/incomplete/overlapping rows stay unknown. */
+declare function readCreateWallTiming(stages: Readonly<Record<string, number>>): CreateWallMeasurement | null;
+//#endregion
+//#region src/server-timing-parser.d.mts
+interface ServerTimingEntry {
+  name: string;
+  dur?: number;
+  desc?: string;
+}
+declare function parseServerTiming(header: string | null | undefined): ServerTimingEntry[];
+declare function parseServerTimingDurations(header: string | null | undefined): Record<string, number>;
+declare const PLATFORM_VERDICT_REUSE_REASONS: readonly ["entry_changed", "refusal_observed", "current_compliance", "negative_age", "retention_elapsed", "key_expired", "feed_missing", "feed_stale", "feed_generation", "dependencies_empty", "dependency_revision", "dependency_floor", "grant_missing", "grant_unreadable", "grant_shape", "grant_negative_age", "grant_retention_elapsed", "shared_refusal_observed", "shared_refusal_unreadable", "shared_read_unavailable", "grant_invalid", "grant_validation", "verification_inflight", "feed_contradiction", "current_required", "lkg_retention_elapsed"];
+type PlatformVerdictReuseRejection = (typeof PLATFORM_VERDICT_REUSE_REASONS)[number];
+declare const HTTP_REQUEST_PHASE_NAMES: readonly ["external.provision", "benchmarks.records.load", "benchmarks.records.build", "benchmarks.records.page", "benchmarks.records.json", "admission.host.list", "host.records.ready", "host.records.scan", "host.records.read", "host.records.metadata", "host.records.project", "host.records.retry", "admission.metadata", "admission.json", "observability.refresh.wait", "fleet.sidecars", "native-export.snapshot.wait", "native-export.prepare.wait", "native-export.collect.wait", "scorecard.fleet.wait", "scorecard.capacity.wait", "scorecard.coverage.wait", "scorecard.compose", "scorecard.json", "proxy.model_refresh", "proxy.hub.lock_wait", "proxy.hub.refresh", "proxy.hub.state", "proxy.hub.proof", "proxy.hub.delivery", "proxy.runtime_token", "snapshot.delete.lock", "snapshot.delete.credentials", "snapshot.delete.list", "snapshot.delete.generation"];
+type HttpRequestPhaseName = (typeof HTTP_REQUEST_PHASE_NAMES)[number];
+declare function httpRequestPhaseFromTimingName(name: string): HttpRequestPhaseName | undefined;
+declare const PLATFORM_VERDICT_SCOPE_CLASSES: readonly ["key", "identity", "owner_user", "owner_team", "lineage", "other"];
+declare const PLATFORM_VERDICT_EVIDENCE_ORDERS: readonly ["feed_before_observation", "feed_at_observation", "feed_after_observation", "unknown"];
+type PlatformVerdictDependencyMismatch = {
+  scopeClass: (typeof PLATFORM_VERDICT_SCOPE_CLASSES)[number];
+  evidenceOrder: (typeof PLATFORM_VERDICT_EVIDENCE_ORDERS)[number];
+};
+declare function createUpstreamHttpPhaseProjection(): {
+  absorb(header: unknown): void;
+  entries(): string[];
+};
+declare const HTTP_PHASE_COVERAGE_FIELDS: readonly ["stored", "emitted", "omitted", "invalid", "collisions", "headerDropped"];
+//#endregion
+export { parentOperations as A, FlowAccountingSpec as C, STOP_ACCOUNTING_SPEC as D, RESUME_ACCOUNTING_SPEC as E, stageTree as M, leafOperations as O, DELETE_ACCOUNTING_SPEC as S, LifecycleWallSample as T, CreateWallPhases as _, PLATFORM_VERDICT_REUSE_REASONS as a, readCreateWallTiming as b, PlatformVerdictReuseRejection as c, httpRequestPhaseFromTimingName as d, parseServerTiming as f, CreateWallPhase as g, CreateWallMeasurement as h, PLATFORM_VERDICT_EVIDENCE_ORDERS as i, partitionLifecycleWalls as j, operationLeafDurations as k, ServerTimingEntry as l, CREATE_WALL_PHASES as m, HTTP_REQUEST_PHASE_NAMES as n, PLATFORM_VERDICT_SCOPE_CLASSES as o, parseServerTimingDurations as p, HttpRequestPhaseName as r, PlatformVerdictDependencyMismatch as s, HTTP_PHASE_COVERAGE_FIELDS as t, createUpstreamHttpPhaseProjection as u, createBookkeepingPostWall as v, LifecycleWallFlow as w, CREATE_ACCOUNTING_SPEC as x, createWallTiming as y };
+//# sourceMappingURL=server-timing-CE4vurML.d.mts.map

package/dist/server-timing-CE4vurML.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-timing-CE4vurML.d.mts","names":["ServerTimingEntry","name","dur","desc","parseServerTiming","header","parseServerTimingDurations","Record","PLATFORM_VERDICT_REUSE_REASONS","PlatformVerdictReuseRejection","HTTP_REQUEST_PHASE_NAMES","HttpRequestPhaseName","httpRequestPhaseFromTimingName","PLATFORM_VERDICT_SCOPE_CLASSES","PLATFORM_VERDICT_EVIDENCE_ORDERS","PlatformVerdictDependencyMismatch","scopeClass","evidenceOrder","createUpstreamHttpPhaseProjection","absorb","entries","HTTP_PHASE_COVERAGE_FIELDS"],"sources":["../src/lifecycle-wall.ts","../src/create-wall.ts","../src/server-timing-parser.d.mts"],"mappings":";;AAoBA;;;;;;;KAAY,kBAAA;EACV,cAAA;EACA,mBAAA,GAAsB,WAAA;EACtB,YAAA;IAAiB,SAAA;EAAA;AAAA;AAAA,cAGN,sBAAA,EAAwB,kBAAA;AAAA,cAQxB,sBAAA,EAAwB,kBAAA;AAAA,cAcxB,oBAAA,EAAsB,kBAAA;AAAA,cAItB,sBAAA,EAAwB,kBAAA;AAAA,UAIpB,oBAAA;EACf,SAAA;EACA,UAAA;EACA,MAAA;AAAA;AAAA,KAEG,MAAA,GAAS,QAAA,CAAS,MAAA;AAAA,UACN,mBAAA;EACf,MAAA;EACA,MAAA;EACA,IAAA,GAAO,MAAA;EACP,OAAA,YAAmB,oBAAA;EACnB,UAAA,GAAa,MAAA;EACb,WAAA;EACA,UAAA,GAAa,MAAA;EACb,SAAA,GAAY,MAAA;EACZ,KAAA;EACA,QAAA;EACA,eAAA;AAAA;AAAA,UAEe,iBAAA,SAA0B,OAAA,CAAQ,kBAAA;EACjD,cAAA;EACA,aAAA;EACA,SAAA;EACA,eAAA;AAAA;;;AAjBF;;;;;;;;;;;;;;;;;iBAuCgB,SAAA,CAAU,MAAA,EAAQ,QAAA,CAAS,MAAA;;;;;;;;;;OA1B1B;;;;;;;;;iBAuED,gBAAA,CACd,UAAA,WAAqB,oBAAA,KACpB,WAAA;;;AA/CH;;;;;;iBA+DgB,cAAA,WAAyB,oBAAA,CAAA,CACvC,UAAA,WAAqB,CAAA,IACrB,QAAA,GAAU,WAAA,UACV,OAAA,GAAO,WAAA,YAA+B,CAAA;;;iBAWxB,sBAAA,CACd,UAAA,WAAqB,oBAAA,IACrB,QAAA,GAAU,WAAA,WAA+B,GAAA;;;;;;iBAoB3B,uBAAA,CACd,MAAA,EAAQ,mBAAA,EACR,IAAA,EAAM,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAxB8B;;;;;;;;;;;;;;;;;;SAwB9B;;;;;;;;;;;;;;;;;;;;;;;;;;;cCzMK,kBAAA;AAAA,KAiBD,eAAA,WAA0B,kBAAA;AAAA,KAC1B,gBAAA,GAAmB,MAAA,CAAO,eAAA;AAAA,UACrB,qBAAA;EACf,MAAA,EAAQ,gBAAA;EACR,OAAA;EDAsB;ECEtB,uBAAA;AAAA;;iBAWc,yBAAA,CAA0B,MAAA,EAAQ,gBAAA;ADTlD;;;;;AAAA,iBCuBgB,gBAAA,CAAiB,SAAA;cAUjB,eAAA,EAAe,EAAA;6BAWP,WAAA,WAEjB,qBAAA;AAAA;;iBA6BS,oBAAA,CACd,MAAA,EAAQ,QAAA,CAAS,MAAA,oBAChB,qBAAA;;;UCvGcA,iBAAAA;EACfC,IAAAA;EACAC,GAAAA;EACAC,IAAAA;AAAAA;AAAAA,iBAGcC,iBAAAA,CACdC,MAAAA,8BACCL,iBAAAA;AAAAA,iBAEaM,0BAAAA,CACdD,MAAAA,8BACCE,MAAAA;AAAAA,cAEUC,8BAAAA;AAAAA,KA4BDC,6BAAAA,WACFD,8BAAAA;AAAAA,cAEGE,wBAAAA;AAAAA,KAqCDC,oBAAAA,WAA+BD,wBAAAA;AAAAA,iBAC3BE,8BAAAA,CACdX,IAAAA,WACCU,oBAAAA;AAAAA,cACUE,8BAAAA;AAAAA,cAQAC,gCAAAA;AAAAA,KAMDC,iCAAAA;EACVC,UAAAA,UAAoBH,8BAAAA;EACpBI,aAAAA,UAAuBH,gCAAAA;AAAAA;AAAAA,iBAGTI,iCAAAA,CAAAA;EACdC,MAAAA,CAAOd,MAAAA;EACPe,OAAAA;AAAAA;AAAAA,cAGWC,0BAAAA"}