@zixt/host 0.0.56 → 0.0.57

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.56",
+  version: "0.0.57",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16232,6 +16232,68 @@ var TaskEventRecord = external_exports.object({
   attachments: external_exports.array(TaskAttachmentRef).max(TASK_MESSAGE_MAX_ATTACHMENTS).optional(),
   at: IsoDate
 });
+var TaskTimingPhaseKind = external_exports.enum([
+  /** Waiting for a Machine: queue, dispatch, and re-queue between runs. */
+  "queued",
+  /** Assigned to a Machine, session not started yet. */
+  "startup",
+  /** Preparing the environment: dependencies, folders, tools, services. */
+  "setup",
+  /** Reading, searching, and browsing to find things out. */
+  "research",
+  /** Doing the Task's actual work: edits, writes, configuration, other tools. */
+  "work",
+  /** Running checks: tests, builds, linters, verification. */
+  "validation",
+  /** Work that happened after checks had already started in the same run. */
+  "rework",
+  /** Reporting and handing off the result: messages, pull requests, files. */
+  "delivery",
+  /** Parked on a question or an approval a person owed. */
+  "awaiting_person",
+  /** Nothing was running: the Task sat between runs with no one waiting on it. */
+  "idle",
+  /** Measured time the Task's activity record cannot break down. */
+  "unattributed"
+]);
+var TaskTimingBasis = external_exports.enum(["measured", "estimated"]);
+var TaskTimingPhase = external_exports.object({
+  kind: TaskTimingPhaseKind,
+  durationMs: external_exports.number().int().min(0),
+  basis: TaskTimingBasis,
+  /** Activity steps behind an estimated phase; 0 for measured lifecycle phases. */
+  steps: external_exports.number().int().min(0)
+}).strict();
+var TaskTimingRun = external_exports.object({
+  epoch: external_exports.number().int().min(1),
+  status: TaskStatus,
+  startedAt: IsoDate.nullable(),
+  finishedAt: IsoDate.nullable(),
+  /** Waiting for this run's Machine, including re-queue after an earlier run. */
+  waitingMs: external_exports.number().int().min(0),
+  activeMs: external_exports.number().int().min(0),
+  unattributedMs: external_exports.number().int().min(0)
+}).strict();
+var TASK_TIMING_MAX_RUNS = 50;
+var TaskTimingBreakdown = external_exports.object({
+  schemaVersion: external_exports.literal(1),
+  from: IsoDate,
+  to: IsoDate,
+  totalElapsedMs: external_exports.number().int().min(0),
+  /** Time a Machine was running the Task, broken down or not. */
+  activeMs: external_exports.number().int().min(0),
+  /** Queue, startup, approval, and idle time: nothing was being worked on. */
+  waitingMs: external_exports.number().int().min(0),
+  /** Active time the activity record cannot name. */
+  unattributedMs: external_exports.number().int().min(0),
+  runCount: external_exports.number().int().min(0),
+  /** False while the Task can still accrue time; the breakdown is then a snapshot. */
+  settled: external_exports.boolean(),
+  /** True once at least one estimated phase carries time worth showing. */
+  attributed: external_exports.boolean(),
+  phases: external_exports.array(TaskTimingPhase),
+  runs: external_exports.array(TaskTimingRun).max(TASK_TIMING_MAX_RUNS)
+}).strict();
 var CreateTaskInput = external_exports.object({
   /** Stable client-generated key: retrying the same submission returns one Task. */
   requestId: external_exports.uuid().optional(),
@@ -16491,7 +16553,9 @@ var TaskDetailResponse = external_exports.object({
   reviewAuthorization: TaskReviewAuthorization,
   context: TaskResolvedContext,
   /** Newest host-observed folder/Git state; null until a current Host reports it. */
-  workingContext: TaskWorkingContext.nullable().default(null)
+  workingContext: TaskWorkingContext.nullable().default(null),
+  /** TS-19 timing breakdown; null when the Task has no usable timing evidence. */
+  timing: TaskTimingBreakdown.nullable().default(null)
 });
 var TaskSupportBundle = external_exports.object({
   schemaVersion: external_exports.literal(1),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",