@zixt/host 0.0.59 → 0.0.61

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.59",
+  version: "0.0.61",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16304,6 +16304,84 @@ var TaskTimingBreakdown = external_exports.object({
   phases: external_exports.array(TaskTimingPhase),
   runs: external_exports.array(TaskTimingRun).max(TASK_TIMING_MAX_RUNS)
 }).strict();
+var TaskProgressStepState = external_exports.enum([
+  /** Reached, and the Task has since moved past it. */
+  "done",
+  /** The furthest step the Task has reached. */
+  "active",
+  /** Not reached yet. */
+  "pending",
+  /** The Task moved past this step without spending measurable time in it. */
+  "skipped"
+]);
+var TaskProgressStep = external_exports.object({
+  kind: TaskTimingPhaseKind,
+  state: TaskProgressStepState,
+  /** Time spent in this step so far; 0 for pending and skipped steps. */
+  durationMs: external_exports.number().int().min(0),
+  /**
+   * What comparable finished Tasks spent here, from their recorded shares
+   * rather than an even split across steps. 0 when no cohort supports one.
+   */
+  expectedMs: external_exports.number().int().min(0)
+}).strict();
+var TaskProgressBasis = external_exports.enum(["none", "steps", "history", "phase_history"]);
+var TaskProgressConfidence = external_exports.enum(["none", "low", "medium"]);
+var TaskProgressCaveat = external_exports.enum([
+  /** A person owes an answer or a decision; nothing is running. */
+  "waiting_on_person",
+  /** Something outside the Task has to change before it can continue. */
+  "blocked",
+  /** No Machine has picked the Task up yet, so no work time has accrued. */
+  "not_started",
+  /** Already past what comparable Tasks needed; the range is a tail guess. */
+  "over_typical",
+  /** Comparable Tasks disagree wildly, so the range is wide on purpose. */
+  "wide_spread",
+  /** Fewer comparable Tasks than the estimate would like. */
+  "thin_history",
+  /** No comparable finished Task exists, so no time can be predicted at all. */
+  "no_history"
+]);
+var TaskProgressSampleScope = external_exports.enum([
+  /** Same teammate, same repository, similar size of request. */
+  "agent_repository_size",
+  /** Same teammate, same repository. */
+  "agent_repository",
+  /** Same teammate, any work. */
+  "agent",
+  /** Anyone in the organization. */
+  "organization"
+]);
+var TaskProgressSample = external_exports.object({
+  size: external_exports.number().int().min(1),
+  scope: TaskProgressSampleScope,
+  /** One in five comparable Tasks finished their work within this. */
+  p20Ms: external_exports.number().int().min(0).default(0),
+  /** Middle working time of the sample. */
+  medianMs: external_exports.number().int().min(0),
+  /** Four in five comparable Tasks finished their work within this. */
+  p80Ms: external_exports.number().int().min(0),
+  /** Newest observation in the cohort; the estimate ages with its evidence. */
+  newestAt: IsoDate.nullable().default(null)
+}).strict();
+var TaskProgressEstimate = external_exports.object({
+  schemaVersion: external_exports.literal(1),
+  /** Whole percent, or null when nothing supports a number. */
+  percent: external_exports.number().int().min(0).max(100).nullable(),
+  basis: TaskProgressBasis,
+  confidence: TaskProgressConfidence,
+  /** Wall-clock since the Task was asked for. */
+  elapsedMs: external_exports.number().int().min(0),
+  /** Of that, time a Machine was actually working. */
+  activeMs: external_exports.number().int().min(0),
+  /** Working time still expected, as a range; null when unknowable. */
+  remaining: external_exports.object({ lowMs: external_exports.number().int().min(0), highMs: external_exports.number().int().min(0) }).strict().nullable(),
+  sample: TaskProgressSample.nullable(),
+  /** Every TS-20 step, in lifecycle order. */
+  steps: external_exports.array(TaskProgressStep),
+  caveat: TaskProgressCaveat.nullable()
+}).strict();
 var CreateTaskInput = external_exports.object({
   /** Stable client-generated key: retrying the same submission returns one Task. */
   requestId: external_exports.uuid().optional(),
@@ -16565,7 +16643,9 @@ var TaskDetailResponse = external_exports.object({
   /** Newest host-observed folder/Git state; null until a current Host reports it. */
   workingContext: TaskWorkingContext.nullable().default(null),
   /** TS-19 timing breakdown; null when the Task has no usable timing evidence. */
-  timing: TaskTimingBreakdown.nullable().default(null)
+  timing: TaskTimingBreakdown.nullable().default(null),
+  /** TS-20 progress estimate; null when the Task has no usable timing evidence. */
+  progress: TaskProgressEstimate.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.59",
+  "version": "0.0.61",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",