@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/runtime/store/domains/tasks.d.ts

@@ -0,0 +1,110 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Tasks domain state — unified task lifecycle tracking across all
+ * subsystem kinds: exec, agent, acp, scheduler, daemon, mcp, plugin, integration.
+ */
+/** States for the task lifecycle machine. */
+export type TaskLifecycleState = 'queued' | 'running' | 'blocked' | 'completed' | 'failed' | 'cancelled';
+/** Task kind used by the runtime task domain. */
+export type TaskKind = 'exec' | 'agent' | 'acp' | 'scheduler' | 'daemon' | 'mcp' | 'plugin' | 'integration';
+/** Retry policy for a task. */
+export interface TaskRetryPolicy {
+    /** Maximum number of retry attempts. */
+    maxAttempts: number;
+    /** Current attempt number (1-indexed). */
+    currentAttempt: number;
+    /** Delay in ms between retries (may be exponential). */
+    delayMs: number;
+    /** Backoff strategy. */
+    backoff: 'fixed' | 'exponential';
+    /** Error categories that trigger retry. */
+    retryOn: Array<'network' | 'timeout' | 'transient' | 'tool_error'>;
+}
+/**
+ * Full runtime task record. Every active or recently completed task
+ * in the system has one of these in the tasks map.
+ */
+export interface RuntimeTask {
+    /** Unique task ID (uuid). */
+    id: string;
+    /** Task kind stored on a runtime task record. */
+    kind: TaskKind;
+    /** Human-readable title for display in task monitor. */
+    title: string;
+    /** Optional detailed description. */
+    description?: string;
+    /** Current lifecycle state. */
+    status: TaskLifecycleState;
+    /** Subsystem or agent ID that owns this task. */
+    owner: string;
+    /** Whether this task can be cancelled by the user. */
+    cancellable: boolean;
+    /** Parent task ID if this is a subtask. */
+    parentTaskId?: string;
+    /** IDs of child tasks spawned by this task. */
+    childTaskIds: string[];
+    /** Epoch ms when the task was queued. */
+    queuedAt: number;
+    /** Epoch ms when the task started running. */
+    startedAt?: number;
+    /** Epoch ms when the task completed, failed, or was cancelled. */
+    endedAt?: number;
+    /** Retry policy (undefined = no retries). */
+    retryPolicy?: TaskRetryPolicy;
+    /**
+     * Computed delay in ms before the next retry attempt.
+     * Set by TaskManager.failTask() when re-queuing. The task runner is
+     * responsible for not starting the task until `retryAt` has elapsed.
+     */
+    retryDelayMs?: number;
+    /**
+     * Epoch ms at which the task is eligible to run again after a retry re-queue.
+     * Computed as `Date.now() + retryDelayMs` by TaskManager.failTask().
+     * The task runner must not dequeue this task before this timestamp.
+     */
+    retryAt?: number;
+    /** Exit code for exec tasks. */
+    exitCode?: number;
+    /** Error message if status === 'failed'. */
+    error?: string;
+    /** Optional structured result payload. */
+    result?: unknown;
+    /** Correlation ID for distributed tracing. */
+    correlationId?: string;
+    /** Turn ID this task was spawned within. */
+    turnId?: string;
+}
+/**
+ * TaskDomainState — all runtime tasks across all subsystems.
+ */
+export interface TaskDomainState {
+    /** Monotonic revision counter; increments on every mutation. */
+    revision: number;
+    /** Timestamp of last mutation (Date.now()). */
+    lastUpdatedAt: number;
+    /** Subsystem that triggered the last mutation. */
+    source: string;
+    /** All known tasks keyed by task ID. */
+    tasks: Map<string, RuntimeTask>;
+    /** IDs of tasks in 'queued' state, ordered by queue time. */
+    queuedIds: string[];
+    /** IDs of tasks in 'running' state. */
+    runningIds: string[];
+    /** IDs of tasks in 'blocked' state. */
+    blockedIds: string[];
+    /** Total tasks created this session. */
+    totalCreated: number;
+    /** Total tasks that completed successfully. */
+    totalCompleted: number;
+    /** Total tasks that failed. */
+    totalFailed: number;
+    /** Total tasks that were cancelled. */
+    totalCancelled: number;
+    /** Maximum concurrent running tasks allowed. */
+    maxConcurrency: number;
+}
+/**
+ * Returns the default initial state for the tasks domain.
+ */
+export declare function createInitialTasksState(): TaskDomainState;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/_internal/platform/runtime/store/domains/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/store/domains/tasks.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/runtime/store/domains/tasks.js

@@ -0,0 +1,20 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Returns the default initial state for the tasks domain.
+ */
+export function createInitialTasksState() {
+    return {
+        revision: 0,
+        lastUpdatedAt: 0,
+        source: 'init',
+        tasks: new Map(),
+        queuedIds: [],
+        runningIds: [],
+        blockedIds: [],
+        totalCreated: 0,
+        totalCompleted: 0,
+        totalFailed: 0,
+        totalCancelled: 0,
+        maxConcurrency: 8,
+    };
+}

package/dist/_internal/platform/runtime/store/domains/telemetry.d.ts

@@ -0,0 +1,91 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Telemetry domain state — tracks runtime observability data including
+ * correlation IDs, session metrics, and structured event counts.
+ *
+ * Correlation IDs and structured event counts are tracked from day one.
+ */
+/** A single structured telemetry event record (lightweight). */
+export interface TelemetryEventRecord {
+    /** Event type identifier. */
+    eventType: string;
+    /** Correlation ID linking this event to a trace. */
+    correlationId: string;
+    /** Subsystem that emitted the event. */
+    source: string;
+    /** Epoch ms when the event was recorded. */
+    timestamp: number;
+    /** Optional structured metadata. */
+    meta?: Record<string, unknown>;
+}
+/** Session-level metric aggregates. */
+export interface SessionMetrics {
+    /** Total turns completed. */
+    turns: number;
+    /** Total tool calls dispatched. */
+    toolCalls: number;
+    /** Total tool call failures. */
+    toolErrors: number;
+    /** Total agents spawned. */
+    agentsSpawned: number;
+    /** Total input tokens consumed. */
+    inputTokens: number;
+    /** Total output tokens generated. */
+    outputTokens: number;
+    /** Total cache read tokens saved. */
+    cacheReadTokens: number;
+    /** Total permission prompts shown. */
+    permissionPrompts: number;
+    /** Total permission denials. */
+    permissionDenials: number;
+    /** Total errors logged. */
+    errors: number;
+    /** Total warnings logged. */
+    warnings: number;
+}
+/** OTel-compatible trace context (populated when OTel is active). */
+export interface TraceContext {
+    /** Trace ID (128-bit hex string). */
+    traceId: string;
+    /** Root span ID (64-bit hex string). */
+    rootSpanId: string;
+    /** Whether OTel export is active. */
+    exportActive: boolean;
+    /** OTel collector endpoint. */
+    endpoint?: string;
+}
+/**
+ * TelemetryDomainState — runtime observability and metrics.
+ */
+export interface TelemetryDomainState {
+    /** Monotonic revision counter; increments on every mutation. */
+    revision: number;
+    /** Timestamp of last mutation (Date.now()). */
+    lastUpdatedAt: number;
+    /** Subsystem that triggered the last mutation. */
+    source: string;
+    /** Session-level correlation ID (set at session start, never changes). */
+    sessionCorrelationId: string;
+    /** Current turn correlation ID (changes each turn). */
+    currentTurnCorrelationId?: string;
+    /** OTel trace context (undefined until OTel is enabled). */
+    traceContext?: TraceContext;
+    /** Accumulated session metrics. */
+    sessionMetrics: SessionMetrics;
+    /**
+     * Ring buffer of recent telemetry events (last N, capped for memory).
+     * Used for the telemetry dashboard and event replay.
+     */
+    recentEvents: TelemetryEventRecord[];
+    /** Maximum number of events to keep in recentEvents. */
+    maxEventBuffer: number;
+    /** Whether the telemetry SQLite DB is available. */
+    dbAvailable: boolean;
+    /** Path to the telemetry DB file. */
+    dbPath?: string;
+}
+/**
+ * Returns the default initial state for the telemetry domain.
+ */
+export declare function createInitialTelemetryState(): TelemetryDomainState;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/_internal/platform/runtime/store/domains/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/store/domains/telemetry.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;GAKG;AAEH,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAEnC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAGf,0EAA0E;IAC1E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,YAAY,CAAC;IAG5B,mCAAmC;IACnC,cAAc,EAAE,cAAc,CAAC;IAG/B;;;OAGG;IACH,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IAGvB,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CA0BlE"}

package/dist/_internal/platform/runtime/store/domains/telemetry.js

@@ -0,0 +1,31 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+/**
+ * Returns the default initial state for the telemetry domain.
+ */
+export function createInitialTelemetryState() {
+    return {
+        revision: 0,
+        lastUpdatedAt: 0,
+        source: 'init',
+        sessionCorrelationId: '',
+        currentTurnCorrelationId: undefined,
+        traceContext: undefined,
+        sessionMetrics: {
+            turns: 0,
+            toolCalls: 0,
+            toolErrors: 0,
+            agentsSpawned: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            cacheReadTokens: 0,
+            permissionPrompts: 0,
+            permissionDenials: 0,
+            errors: 0,
+            warnings: 0,
+        },
+        recentEvents: [],
+        maxEventBuffer: 500,
+        dbAvailable: false,
+        dbPath: undefined,
+    };
+}

package/dist/_internal/platform/runtime/store/domains/watchers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Watcher domain state — managed sources that feed automation and routes.
+ */
+import type { AutomationSourceRecord } from '../../../automation/sources.js';
+export type WatcherKind = 'webhook' | 'polling' | 'filesystem' | 'socket' | 'integration' | 'manual';
+export type WatcherState = 'stopped' | 'starting' | 'running' | 'degraded' | 'failed';
+export type WatcherSourceStatus = 'healthy' | 'lagging' | 'stale' | 'degraded' | 'failed' | 'unknown';
+export interface WatcherRecord {
+    readonly id: string;
+    readonly kind: WatcherKind;
+    readonly label: string;
+    readonly state: WatcherState;
+    readonly source: AutomationSourceRecord;
+    readonly intervalMs?: number;
+    readonly lastHeartbeatAt?: number;
+    readonly sourceLagMs?: number;
+    readonly sourceStatus?: WatcherSourceStatus;
+    readonly degradedReason?: string;
+    readonly lastCheckpoint?: string;
+    readonly lastError?: string;
+    readonly metadata: Record<string, unknown>;
+}
+export interface WatcherDomainState {
+    readonly revision: number;
+    readonly lastUpdatedAt: number;
+    readonly source: string;
+    readonly watchers: Map<string, WatcherRecord>;
+    readonly watcherIds: string[];
+    readonly activeWatcherIds: string[];
+    readonly failedWatcherIds: string[];
+    readonly totalStarted: number;
+    readonly totalStopped: number;
+    readonly totalFailed: number;
+    readonly totalHeartbeats: number;
+    readonly totalDegraded: number;
+    readonly totalLagged: number;
+}
+export declare function createInitialWatcherState(): WatcherDomainState;
+//# sourceMappingURL=watchers.d.ts.map

package/dist/_internal/platform/runtime/store/domains/watchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchers.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/store/domains/watchers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAC;AACrG,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AACtF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,CAgB9D"}

package/dist/_internal/platform/runtime/store/domains/watchers.js

@@ -0,0 +1,20 @@
+/**
+ * Watcher domain state — managed sources that feed automation and routes.
+ */
+export function createInitialWatcherState() {
+    return {
+        revision: 0,
+        lastUpdatedAt: 0,
+        source: 'init',
+        watchers: new Map(),
+        watcherIds: [],
+        activeWatcherIds: [],
+        failedWatcherIds: [],
+        totalStarted: 0,
+        totalStopped: 0,
+        totalFailed: 0,
+        totalHeartbeats: 0,
+        totalDegraded: 0,
+        totalLagged: 0,
+    };
+}

package/dist/_internal/platform/runtime/tasks/lifecycle.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Task lifecycle state machine — pure transition logic with no side effects.
+ *
+ * Implements the task lifecycle state machine:
+ *
+ * ```
+ * queued → running
+ * running → blocked | completed | failed | cancelled | queued (retry re-queue)
+ * blocked → running | cancelled | failed
+ * completed → (terminal)
+ * failed → (terminal)
+ * cancelled → (terminal)
+ * ```
+ */
+import type { TaskLifecycleState } from '../store/domains/tasks.js';
+/**
+ * Returns true if a transition from `from` to `to` is permitted by the
+ * task lifecycle state machine.
+ *
+ * @param from - Current task status.
+ * @param to - Desired target status.
+ * @returns `true` if the transition is valid; `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * canTransition('queued', 'running');    // true
+ * canTransition('completed', 'running'); // false
+ * canTransition('running', 'blocked');   // true
+ * ```
+ */
+export declare function canTransition(from: TaskLifecycleState, to: TaskLifecycleState): boolean;
+/**
+ * Returns the set of states reachable from `from` in one transition.
+ *
+ * @param from - Current task status.
+ * @returns Array of valid target statuses (may be empty for terminal states).
+ *
+ * @example
+ * ```ts
+ * getValidTransitions('running');
+ * // => ['blocked', 'completed', 'failed', 'cancelled']
+ *
+ * getValidTransitions('completed');
+ * // => []
+ * ```
+ */
+export declare function getValidTransitions(from: TaskLifecycleState): TaskLifecycleState[];
+/**
+ * Returns true if `status` is a terminal lifecycle state (no further
+ * transitions are possible).
+ *
+ * @param status - The task status to check.
+ */
+export declare function isTerminalStatus(status: TaskLifecycleState): boolean;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/_internal/platform/runtime/tasks/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/tasks/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAepE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,kBAAkB,GACrB,OAAO,CAET;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,EAAE,CAEtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEpE"}

package/dist/_internal/platform/runtime/tasks/lifecycle.js

@@ -0,0 +1,57 @@
+/**
+ * Adjacency list for valid task state transitions.
+ * Terminal states map to empty arrays — no outbound transitions.
+ */
+const VALID_TRANSITIONS = {
+    queued: ['running', 'cancelled'],
+    running: ['blocked', 'completed', 'failed', 'cancelled', 'queued'], // queued = retry re-queue
+    blocked: ['running', 'cancelled', 'failed'],
+    completed: [],
+    failed: [],
+    cancelled: [],
+};
+/**
+ * Returns true if a transition from `from` to `to` is permitted by the
+ * task lifecycle state machine.
+ *
+ * @param from - Current task status.
+ * @param to - Desired target status.
+ * @returns `true` if the transition is valid; `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * canTransition('queued', 'running');    // true
+ * canTransition('completed', 'running'); // false
+ * canTransition('running', 'blocked');   // true
+ * ```
+ */
+export function canTransition(from, to) {
+    return VALID_TRANSITIONS[from].includes(to);
+}
+/**
+ * Returns the set of states reachable from `from` in one transition.
+ *
+ * @param from - Current task status.
+ * @returns Array of valid target statuses (may be empty for terminal states).
+ *
+ * @example
+ * ```ts
+ * getValidTransitions('running');
+ * // => ['blocked', 'completed', 'failed', 'cancelled']
+ *
+ * getValidTransitions('completed');
+ * // => []
+ * ```
+ */
+export function getValidTransitions(from) {
+    return [...VALID_TRANSITIONS[from]];
+}
+/**
+ * Returns true if `status` is a terminal lifecycle state (no further
+ * transitions are possible).
+ *
+ * @param status - The task status to check.
+ */
+export function isTerminalStatus(status) {
+    return VALID_TRANSITIONS[status].length === 0;
+}

package/dist/_internal/platform/runtime/tasks/registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * TaskRegistry — in-memory index for RuntimeTask lookup by ID, kind, status,
+ * and parent/child relationships.
+ *
+ * This is a pure data structure with no side effects. The UnifiedTaskManager
+ * owns the registry instance and is responsible for keeping it consistent with
+ * the Zustand store.
+ */
+import type { RuntimeTask, TaskKind } from '../store/domains/tasks.js';
+/**
+ * TaskRegistry — provides O(1) task lookup by ID and O(k) lookup by kind,
+ * running status, and parent task.
+ *
+ * All mutation methods return `this` for chaining.
+ */
+export declare class TaskRegistry {
+    /** Primary task index keyed by task ID. */
+    private readonly _tasks;
+    /**
+     * Registers a task in the registry. If a task with the same ID already
+     * exists it is replaced (treated as an update).
+     *
+     * @param task - The RuntimeTask to register.
+     */
+    register(task: RuntimeTask): this;
+    /**
+     * Removes a task from the registry by ID.
+     *
+     * @param id - The task ID to remove.
+     * @returns `true` if the task existed and was removed; `false` otherwise.
+     */
+    deregister(id: string): boolean;
+    /**
+     * Retrieves a task by its unique ID.
+     *
+     * @param id - The task ID to look up.
+     * @returns The RuntimeTask if found, or `undefined`.
+     */
+    get(id: string): RuntimeTask | undefined;
+    /**
+     * Returns all tasks of a given kind.
+     *
+     * @param kind - The TaskKind to filter by.
+     * @returns Array of matching RuntimeTask records (may be empty).
+     */
+    getByKind(kind: TaskKind): RuntimeTask[];
+    /**
+     * Returns all currently running tasks (status === 'running').
+     *
+     * @returns Array of RuntimeTask records with status 'running'.
+     */
+    getRunning(): RuntimeTask[];
+    /**
+     * Returns all tasks that are direct children of the given parent task ID.
+     *
+     * @param parentId - The parent task ID.
+     * @returns Array of child RuntimeTask records (may be empty).
+     */
+    getChildren(parentId: string): RuntimeTask[];
+    /**
+     * Returns all tasks matching the given status.
+     *
+     * @param status - The lifecycle status to filter by.
+     * @returns Array of RuntimeTask records with the given status.
+     */
+    getByStatus(status: RuntimeTask['status']): RuntimeTask[];
+    /**
+     * Returns the total number of tasks currently tracked in the registry.
+     */
+    get size(): number;
+    /**
+     * Returns a snapshot of all tasks as a new Map.
+     * Mutations to the returned Map do not affect the registry.
+     */
+    snapshot(): Map<string, RuntimeTask>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/_internal/platform/runtime/tasks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/tasks/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD;;;;;OAKG;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAKxC;;;;;OAKG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC;;;;;OAKG;IACI,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C;;;;;OAKG;IACI,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE;IAU/C;;;;OAIG;IACI,UAAU,IAAI,WAAW,EAAE;IAUlC;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAUnD;;;;;OAKG;IACI,WAAW,CAChB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC5B,WAAW,EAAE;IAUhB;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;CAG5C"}

package/dist/_internal/platform/runtime/tasks/registry.js

@@ -0,0 +1,110 @@
+/**
+ * TaskRegistry — provides O(1) task lookup by ID and O(k) lookup by kind,
+ * running status, and parent task.
+ *
+ * All mutation methods return `this` for chaining.
+ */
+export class TaskRegistry {
+    /** Primary task index keyed by task ID. */
+    _tasks = new Map();
+    /**
+     * Registers a task in the registry. If a task with the same ID already
+     * exists it is replaced (treated as an update).
+     *
+     * @param task - The RuntimeTask to register.
+     */
+    register(task) {
+        this._tasks.set(task.id, task);
+        return this;
+    }
+    /**
+     * Removes a task from the registry by ID.
+     *
+     * @param id - The task ID to remove.
+     * @returns `true` if the task existed and was removed; `false` otherwise.
+     */
+    deregister(id) {
+        return this._tasks.delete(id);
+    }
+    /**
+     * Retrieves a task by its unique ID.
+     *
+     * @param id - The task ID to look up.
+     * @returns The RuntimeTask if found, or `undefined`.
+     */
+    get(id) {
+        return this._tasks.get(id);
+    }
+    /**
+     * Returns all tasks of a given kind.
+     *
+     * @param kind - The TaskKind to filter by.
+     * @returns Array of matching RuntimeTask records (may be empty).
+     */
+    getByKind(kind) {
+        const results = [];
+        for (const task of this._tasks.values()) {
+            if (task.kind === kind) {
+                results.push(task);
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns all currently running tasks (status === 'running').
+     *
+     * @returns Array of RuntimeTask records with status 'running'.
+     */
+    getRunning() {
+        const results = [];
+        for (const task of this._tasks.values()) {
+            if (task.status === 'running') {
+                results.push(task);
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns all tasks that are direct children of the given parent task ID.
+     *
+     * @param parentId - The parent task ID.
+     * @returns Array of child RuntimeTask records (may be empty).
+     */
+    getChildren(parentId) {
+        const results = [];
+        for (const task of this._tasks.values()) {
+            if (task.parentTaskId === parentId) {
+                results.push(task);
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns all tasks matching the given status.
+     *
+     * @param status - The lifecycle status to filter by.
+     * @returns Array of RuntimeTask records with the given status.
+     */
+    getByStatus(status) {
+        const results = [];
+        for (const task of this._tasks.values()) {
+            if (task.status === status) {
+                results.push(task);
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns the total number of tasks currently tracked in the registry.
+     */
+    get size() {
+        return this._tasks.size;
+    }
+    /**
+     * Returns a snapshot of all tasks as a new Map.
+     * Mutations to the returned Map do not affect the registry.
+     */
+    snapshot() {
+        return new Map(this._tasks);
+    }
+}