@jmanuelcorral/openteam 0.13.1 → 0.14.0

package/dist/telemetry/events.d.ts

@@ -92,6 +92,30 @@ export declare const MeetingEventSchema: z.ZodObject<{
     roles: z.ZodArray<z.ZodString>;
     decisionIDs: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
+/**
+ * Per-dispatch local-runtime queue metric (#144 observability). Emitted once for
+ * each dispatched role task that passed through the per-runtime concurrency
+ * limiter, so an orchestrated run under load produces queue-wait samples an
+ * operator can aggregate into p50/p95 — the measurement that a post-load
+ * snapshot cannot reconstruct.
+ *
+ * Privacy: ids, counts and one duration only — never prompt text, tool
+ * arguments, or output. `waitedMs` is `0` when a slot was free; `activeCount`
+ * and `queuedCount` are observed at the moment the slot was granted.
+ */
+export declare const QueueEventSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    ts: z.ZodNumber;
+    sessionID: z.ZodString;
+    type: z.ZodLiteral<"queue">;
+    runtimeId: z.ZodString;
+    waitedMs: z.ZodNumber;
+    activeCount: z.ZodNumber;
+    queuedCount: z.ZodNumber;
+    decisionID: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    batchID: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 /** Recorded decision/learning (scribe or orchestrator), redacted. */
 export declare const DecisionEventSchema: z.ZodObject<{
     v: z.ZodLiteral<1>;
@@ -284,6 +308,18 @@ export declare const OpenTeamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     purpose: z.ZodOptional<z.ZodString>;
     roles: z.ZodArray<z.ZodString>;
     decisionIDs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    ts: z.ZodNumber;
+    sessionID: z.ZodString;
+    type: z.ZodLiteral<"queue">;
+    runtimeId: z.ZodString;
+    waitedMs: z.ZodNumber;
+    activeCount: z.ZodNumber;
+    queuedCount: z.ZodNumber;
+    decisionID: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    batchID: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     v: z.ZodLiteral<1>;
     ts: z.ZodNumber;
@@ -361,6 +397,7 @@ export type RouteEvent = z.infer<typeof RouteEventSchema>;
 export type MessageEvent = z.infer<typeof MessageEventSchema>;
 export type ToolcallEvent = z.infer<typeof ToolcallEventSchema>;
 export type MeetingEvent = z.infer<typeof MeetingEventSchema>;
+export type QueueEvent = z.infer<typeof QueueEventSchema>;
 export type DecisionEvent = z.infer<typeof DecisionEventSchema>;
 export type ActivityEvent = z.infer<typeof ActivityEventSchema>;
 export type SessionEndpointEvent = z.infer<typeof SessionEndpointEventSchema>;

package/dist/telemetry/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAa/C,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqB3B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;kBAc7B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;kBAS9B,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;;;;;;kBAM7B,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;kBAK9B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;kBAK9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;kBAMrC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;kBActC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;EAA6C,CAAC;AAChF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAA2B,CAAC;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;kBAIhC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAU9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAa/C,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqB3B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;kBAc7B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;kBAS9B,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;;;;;;kBAM7B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kBAgB3B,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;kBAK9B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;kBAK9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;kBAMrC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;kBActC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;EAA6C,CAAC;AAChF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAA2B,CAAC;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;kBAIhC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAW9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/telemetry/queueWait.d.ts

@@ -0,0 +1,51 @@
+import type { QueueEvent } from "./events";
+/**
+ * Aggregated local-runtime queue-wait metrics derived from `queue` events
+ * (#144). Produced by {@link summarizeQueueWaits} and rendered by
+ * `openteam doctor` so an operator can read the p50/p95 wait a live load
+ * incurred — the measurement a post-load snapshot cannot reconstruct.
+ *
+ * Pure data: counts and durations only, no prompt content.
+ */
+export type QueueWaitRuntimeSummary = {
+    /** Local runtime id (e.g. `lemonade`). */
+    readonly runtimeId: string;
+    /** Number of dispatch samples observed for this runtime. */
+    readonly samples: number;
+    /** Samples that actually queued (waited more than 0 ms). */
+    readonly contended: number;
+    /** Median queue wait in milliseconds across this runtime's samples. */
+    readonly p50Ms: number;
+    /** 95th-percentile queue wait in milliseconds across this runtime's samples. */
+    readonly p95Ms: number;
+    /** Maximum queue wait in milliseconds observed for this runtime. */
+    readonly maxMs: number;
+    /** Highest queued (waiting) count observed at an acquisition for this runtime. */
+    readonly maxQueued: number;
+    /** Highest active (in-flight) count observed at an acquisition for this runtime. */
+    readonly maxActive: number;
+};
+/**
+ * Whole-fleet plus per-runtime queue-wait roll-up. `undefined` from
+ * {@link summarizeQueueWaits} means no `queue` samples were recorded at all,
+ * which the caller reports as "no data" rather than as zero contention.
+ */
+export type QueueWaitSummary = {
+    readonly samples: number;
+    readonly contended: number;
+    readonly p50Ms: number;
+    readonly p95Ms: number;
+    readonly maxMs: number;
+    readonly maxQueued: number;
+    readonly maxActive: number;
+    /** Per-runtime breakdown, sorted by runtime id for deterministic output. */
+    readonly perRuntime: readonly QueueWaitRuntimeSummary[];
+};
+/**
+ * Aggregates `queue` events into fleet-wide and per-runtime p50/p95 wait,
+ * contention counts, and peak active/queued depths. Pure and deterministic:
+ * same events (in any order) produce the same summary. Returns `undefined` when
+ * there are no samples so callers can distinguish "no data" from "no wait".
+ */
+export declare function summarizeQueueWaits(events: readonly QueueEvent[]): QueueWaitSummary | undefined;
+//# sourceMappingURL=queueWait.d.ts.map

package/dist/telemetry/queueWait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueWait.d.ts","sourceRoot":"","sources":["../../src/telemetry/queueWait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACzD,CAAC;AA+BF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,gBAAgB,GAAG,SAAS,CAmD9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmanuelcorral/openteam",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "packageManager": "bun@1.3.14",
   "description": "Cost-aware, local-first routing plugin for opencode with cheapest-capable frontier fallback and multi-agent orchestration.",
   "license": "MIT",