@happier-dev/stack 0.2.1-preview.1775586714.26562 → 0.2.12-preview.1

package/node_modules/@happier-dev/protocol/dist/sessionActivityHeadlineOrdering.js

@@ -0,0 +1,66 @@
+/**
+ * The one owner of how a session-activity headline is ordered and bounded.
+ *
+ * A "headline" is the compact, count-only live pointer a session publishes into its metadata. There
+ * are two of them — `sessionWorkflowActivityHeadlineV1` and `sessionAgentActivityHeadlineV1` — and
+ * the second is DERIVED from the first (PLAN §3.1), not parallel to it. Both call the functions
+ * below, so a second comparator or a second cap cannot appear without deleting one of these.
+ *
+ * Three semantics live here, and each exists because getting it wrong is a user-visible defect:
+ *
+ * 1. **Active entries are never capped.** How much work is running concurrently is provider
+ *    behaviour, not a Happier limit. Capping it would make a roster silently incomplete, which is
+ *    the exact failure R-3 exists to prevent.
+ * 2. **Only terminal history is bounded**, newest first, with the omitted count reported so a
+ *    consumer knows the history is partial instead of inferring that nothing else ever happened.
+ * 3. **Progress timestamps take no part in active ordering.** Active work updates constantly; an
+ *    `updatedAt`-ordered active list reshuffles the badge and the popover on every progress tick,
+ *    under the eyes of someone reading it. Ordering is priority first, identity as the tie-break,
+ *    which makes it a *total* order — every client derives the same sequence and therefore the same
+ *    primary entry.
+ *
+ * Deliberately generic and dependency-free: the domain supplies terminality, priority and the
+ * projection, because those are vocabulary decisions. This module owns only the mechanism, and
+ * knows nothing about workflows, agents, or which key a headline is published under.
+ */
+function compareById(accessors, left, right) {
+    const leftId = accessors.id(left);
+    const rightId = accessors.id(right);
+    return leftId < rightId ? -1 : leftId > rightId ? 1 : 0;
+}
+/** Deterministic active ordering: ascending priority, then ascending id. Pure; never mutates. */
+export function sortActiveActivityHeadlineEntries(entries, accessors) {
+    return [...entries].sort((left, right) => (accessors.activePriority(left) - accessors.activePriority(right)
+        || compareById(accessors, left, right)));
+}
+/** Bound terminal history only: newest first, then ascending id, sliced to `limit`. */
+export function boundRecentActivityHeadlineEntries(entries, accessors, limit) {
+    const sorted = [...entries].sort((left, right) => (accessors.updatedAt(right) - accessors.updatedAt(left)
+        || compareById(accessors, left, right)));
+    const recent = sorted.slice(0, Math.max(0, limit));
+    return { recent, omittedCount: sorted.length - recent.length };
+}
+/**
+ * Project, split active from terminal, order each side by its own rule, and bound the terminal side.
+ * The single entry point both headline builders use.
+ */
+export function partitionActivityHeadlineEntries(input) {
+    const active = [];
+    const terminal = [];
+    for (const rawEntry of input.entries) {
+        const entry = input.project(rawEntry);
+        if (input.isTerminal(entry)) {
+            terminal.push(entry);
+        }
+        else {
+            active.push(entry);
+        }
+    }
+    const bounded = boundRecentActivityHeadlineEntries(terminal, input.accessors, input.recentLimit);
+    return {
+        active: sortActiveActivityHeadlineEntries(active, input.accessors),
+        recent: bounded.recent,
+        omittedCount: bounded.omittedCount,
+    };
+}
+//# sourceMappingURL=sessionActivityHeadlineOrdering.js.map

package/node_modules/@happier-dev/protocol/dist/sessionActivityHeadlineOrdering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionActivityHeadlineOrdering.js","sourceRoot":"","sources":["../src/sessionActivityHeadlineOrdering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA6CH,SAAS,WAAW,CAClB,SAA6D,EAC7D,IAAY,EACZ,KAAa;IAEb,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iCAAiC,CAC/C,OAA0B,EAC1B,SAAgF;IAEhF,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CACxC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC;WAC7D,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC,CAAC;AACL,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kCAAkC,CAChD,OAA0B,EAC1B,SAA2E,EAC3E,KAAa;IAEb,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAChD,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;WACnD,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAoD;IAEpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,kCAAkC,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACjG,OAAO;QACL,MAAM,EAAE,iCAAiC,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromExecutionRunStatus.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionRunStatus } from '../../executionRunListRequest.js';
+import type { AgentActivityStatusV1 } from '../agentActivityStatusV1.js';
+/**
+ * `ExecutionRunStatus` (daemon execution-run registry) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract. No `default` arm: a value added
+ * upstream must fail to compile here.
+ *
+ * `timeout` has its own presentation status. Collapsing it into `succeeded` is defect D-1 — a run
+ * the daemon timed out rendering as a green success is a lie the user cannot see through, and
+ * timing out has a different recovery (raise the budget) than failing (read the error).
+ */
+export declare function fromExecutionRunStatus(status: ExecutionRunStatus): AgentActivityStatusV1;
+//# sourceMappingURL=fromExecutionRunStatus.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromExecutionRunStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromExecutionRunStatus.d.ts","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromExecutionRunStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAiBxF"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromExecutionRunStatus.js

@@ -0,0 +1,29 @@
+/**
+ * `ExecutionRunStatus` (daemon execution-run registry) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract. No `default` arm: a value added
+ * upstream must fail to compile here.
+ *
+ * `timeout` has its own presentation status. Collapsing it into `succeeded` is defect D-1 — a run
+ * the daemon timed out rendering as a green success is a lie the user cannot see through, and
+ * timing out has a different recovery (raise the budget) than failing (read the error).
+ */
+export function fromExecutionRunStatus(status) {
+    switch (status) {
+        case 'running':
+            return 'running';
+        case 'succeeded':
+            return 'succeeded';
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            return 'cancelled';
+        case 'timeout':
+            return 'timedOut';
+        default: {
+            const exhaustive = status;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=fromExecutionRunStatus.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromExecutionRunStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromExecutionRunStatus.js","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromExecutionRunStatus.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAC/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromSubagentStatus.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { AgentActivityStatusV1 } from '../agentActivityStatusV1.js';
+/**
+ * Boundary vocabulary for the client-derived subagent status.
+ *
+ * The canonical owner is `SessionSubagentStatus` at
+ * `apps/ui/sources/sync/domains/session/subagents/types.ts`. It is derived from transcript
+ * observation rather than published on the wire, and `packages/protocol` cannot import from
+ * `apps/ui`, so this schema is the boundary mirror the adapter is typed against — it does not take
+ * ownership away from the UI type and must stay in step with it.
+ *
+ * The lock has two halves: a UI caller passing a `SessionSubagentStatus` straight into
+ * `fromSubagentStatus` fails to compile when the mirror is missing a member, and
+ * `sessionSubagentStatusProtocolParity.test.ts` in `apps/ui` asserts set equality so a member added
+ * here without a UI counterpart (or vice versa) fails loudly instead of drifting. That test lives
+ * on the UI side because only that side can see both vocabularies.
+ */
+export declare const SESSION_SUBAGENT_STATUS_SOURCES_V1: readonly ['running', 'succeeded', 'failed', 'timedOut', 'cancelled', 'terminated', 'unknown'];
+export declare const SessionSubagentStatusSourceV1Schema: z.ZodEnum<{
+    cancelled: "cancelled";
+    failed: "failed";
+    running: "running";
+    succeeded: "succeeded";
+    terminated: "terminated";
+    timedOut: "timedOut";
+    unknown: "unknown";
+}>;
+export type SessionSubagentStatusSourceV1 = z.infer<typeof SessionSubagentStatusSourceV1Schema>;
+/**
+ * Subagent status -> presentation status. No `default` arm: a value added upstream must fail to
+ * compile here.
+ */
+export declare function fromSubagentStatus(status: SessionSubagentStatusSourceV1): AgentActivityStatusV1;
+//# sourceMappingURL=fromSubagentStatus.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromSubagentStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromSubagentStatus.d.ts","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromSubagentStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kCAAkC,YAC7C,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,CACD,CAAC;AAEX,eAAO,MAAM,mCAAmC;;;;;;;;EAA6C,CAAC;AAC9F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,6BAA6B,GAAG,qBAAqB,CAsB/F"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromSubagentStatus.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+/**
+ * Boundary vocabulary for the client-derived subagent status.
+ *
+ * The canonical owner is `SessionSubagentStatus` at
+ * `apps/ui/sources/sync/domains/session/subagents/types.ts`. It is derived from transcript
+ * observation rather than published on the wire, and `packages/protocol` cannot import from
+ * `apps/ui`, so this schema is the boundary mirror the adapter is typed against — it does not take
+ * ownership away from the UI type and must stay in step with it.
+ *
+ * The lock has two halves: a UI caller passing a `SessionSubagentStatus` straight into
+ * `fromSubagentStatus` fails to compile when the mirror is missing a member, and
+ * `sessionSubagentStatusProtocolParity.test.ts` in `apps/ui` asserts set equality so a member added
+ * here without a UI counterpart (or vice versa) fails loudly instead of drifting. That test lives
+ * on the UI side because only that side can see both vocabularies.
+ */
+export const SESSION_SUBAGENT_STATUS_SOURCES_V1 = [
+    'running',
+    'succeeded',
+    'failed',
+    'timedOut',
+    'cancelled',
+    'terminated',
+    'unknown',
+];
+export const SessionSubagentStatusSourceV1Schema = z.enum(SESSION_SUBAGENT_STATUS_SOURCES_V1);
+/**
+ * Subagent status -> presentation status. No `default` arm: a value added upstream must fail to
+ * compile here.
+ */
+export function fromSubagentStatus(status) {
+    switch (status) {
+        case 'running':
+            return 'running';
+        case 'succeeded':
+            return 'succeeded';
+        case 'failed':
+            return 'failed';
+        case 'timedOut':
+            // Kept distinct from `failed`: the recovery is to raise the budget, not to read an error.
+            return 'timedOut';
+        case 'cancelled':
+        case 'terminated':
+            // `terminated` is a stop, not an error; it collapses into `cancelled` by design.
+            return 'cancelled';
+        case 'unknown':
+            return 'unknown';
+        default: {
+            const exhaustive = status;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=fromSubagentStatus.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromSubagentStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromSubagentStatus.js","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromSubagentStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;IACZ,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;AAG9F;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqC;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU;YACb,0FAA0F;YAC1F,OAAO,UAAU,CAAC;QACpB,KAAK,WAAW,CAAC;QACjB,KAAK,YAAY;YACf,iFAAiF;YACjF,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowAgentStatus.d.ts

@@ -0,0 +1,10 @@
+import type { SessionWorkflowAgentStatusV1 } from '../../sessionWorkflowActivity/sessionWorkflowRunSnapshotV1.js';
+import type { AgentActivityStatusV1 } from '../agentActivityStatusV1.js';
+/**
+ * `SessionWorkflowAgentStatusV1` (one agent inside a durable workflow run) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract. No `default` arm: a value added
+ * upstream must fail to compile here.
+ */
+export declare function fromWorkflowAgentStatus(status: SessionWorkflowAgentStatusV1): AgentActivityStatusV1;
+//# sourceMappingURL=fromWorkflowAgentStatus.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowAgentStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromWorkflowAgentStatus.d.ts","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromWorkflowAgentStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+DAA+D,CAAC;AAClH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,4BAA4B,GAAG,qBAAqB,CAsBnG"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowAgentStatus.js

@@ -0,0 +1,30 @@
+/**
+ * `SessionWorkflowAgentStatusV1` (one agent inside a durable workflow run) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract. No `default` arm: a value added
+ * upstream must fail to compile here.
+ */
+export function fromWorkflowAgentStatus(status) {
+    switch (status) {
+        case 'pending':
+            // Admitted to the run's phase plan but not dispatched.
+            return 'queued';
+        case 'active':
+            return 'running';
+        case 'complete':
+            return 'succeeded';
+        case 'failed':
+            return 'failed';
+        case 'blocked':
+            return 'blocked';
+        case 'cancelled':
+            return 'cancelled';
+        case 'unknown':
+            return 'unknown';
+        default: {
+            const exhaustive = status;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=fromWorkflowAgentStatus.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowAgentStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromWorkflowAgentStatus.js","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromWorkflowAgentStatus.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAoC;IAC1E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,uDAAuD;YACvD,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowRunStatus.d.ts

@@ -0,0 +1,10 @@
+import type { SessionWorkflowRunStatusV1 } from '../../sessionWorkflowActivity/sessionWorkflowRunSnapshotV1.js';
+import type { AgentActivityStatusV1 } from '../agentActivityStatusV1.js';
+/**
+ * `SessionWorkflowRunStatusV1` (durable `activity/workflow_run.v1` record) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract; this is the boundary where it becomes
+ * presentable. No `default` arm: a value added upstream must fail to compile here.
+ */
+export declare function fromWorkflowRunStatus(status: SessionWorkflowRunStatusV1): AgentActivityStatusV1;
+//# sourceMappingURL=fromWorkflowRunStatus.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowRunStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromWorkflowRunStatus.d.ts","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromWorkflowRunStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,0BAA0B,GAAG,qBAAqB,CAyB/F"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowRunStatus.js

@@ -0,0 +1,33 @@
+/**
+ * `SessionWorkflowRunStatusV1` (durable `activity/workflow_run.v1` record) -> presentation status.
+ *
+ * The source enum is unchanged and still the wire contract; this is the boundary where it becomes
+ * presentable. No `default` arm: a value added upstream must fail to compile here.
+ */
+export function fromWorkflowRunStatus(status) {
+    switch (status) {
+        case 'active':
+            return 'running';
+        case 'complete':
+            return 'succeeded';
+        case 'failed':
+            return 'failed';
+        case 'stopped':
+            // A run left active when its CLI process died is reconciled to `stopped`
+            // (`statusReason: 'interrupted'`). A stop is not a failure and must not read as danger.
+            return 'cancelled';
+        case 'blocked':
+            // Workflow `blocked` waits on a phase dependency, not on a person, so it is `blocked` and
+            // not `waiting`. Human-blocking arrives as an attention signal on the entry, not here.
+            return 'blocked';
+        case 'cancelled':
+            return 'cancelled';
+        case 'unknown':
+            return 'unknown';
+        default: {
+            const exhaustive = status;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=fromWorkflowRunStatus.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/fromWorkflowRunStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromWorkflowRunStatus.js","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/fromWorkflowRunStatus.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkC;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,yEAAyE;YACzE,wFAAwF;YACxF,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,0FAA0F;YAC1F,uFAAuF;YACvF,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/index.d.ts

@@ -0,0 +1,5 @@
+export { fromExecutionRunStatus } from './fromExecutionRunStatus.js';
+export { SESSION_SUBAGENT_STATUS_SOURCES_V1, SessionSubagentStatusSourceV1Schema, fromSubagentStatus, type SessionSubagentStatusSourceV1, } from './fromSubagentStatus.js';
+export { fromWorkflowAgentStatus } from './fromWorkflowAgentStatus.js';
+export { fromWorkflowRunStatus } from './fromWorkflowRunStatus.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,kBAAkB,EAClB,KAAK,6BAA6B,GACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/index.js

@@ -0,0 +1,5 @@
+export { fromExecutionRunStatus } from './fromExecutionRunStatus.js';
+export { SESSION_SUBAGENT_STATUS_SOURCES_V1, SessionSubagentStatusSourceV1Schema, fromSubagentStatus, } from './fromSubagentStatus.js';
+export { fromWorkflowAgentStatus } from './fromWorkflowAgentStatus.js';
+export { fromWorkflowRunStatus } from './fromWorkflowRunStatus.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sessionAgentActivity/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/agentActivityEntryId.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The one owner of how a unit of agent work is named.
+ *
+ * `deriveAgentActivityEntries` unions the headline the CLI publishes with the entries the UI derives
+ * from the transcript, and it unions them BY ID. Two spellings of one agent — `workflow_agent:wf_1:a1`
+ * on the producer against `wf_1/a1` on the consumer — therefore render that agent twice, with every
+ * schema valid, every test green and nothing failing loudly. That is the failure this module exists
+ * to make impossible: the CLI projection and the UI merge both import these functions, so there is
+ * one spelling by construction, and the hand-written literals in the test are the lock on it.
+ *
+ * Two separate identifiers live here, and conflating them is the subtle mistake:
+ *
+ * - **The entry id** is what a row is keyed by and what the headline publishes. It is namespaced by
+ *   the run an agent belongs to, because a provider agent id is only unique inside its run — a
+ *   recorded two-run workflow fixture labels an agent `workflow-agent:1` in BOTH of its runs.
+ * - **The agent handle** is the provider-side tool-use id underneath. It is the ONLY identifier the
+ *   two sides can independently produce for the same work: the CLI sees the SDK's `tool_use` id
+ *   (`claudeWorkflowCorrelation.parseSubagentToolUse` → the agent's snapshot id), and the UI sees the
+ *   transcript tool call whose id doubles as the sidechain id (`resolveToolTranscriptSidechainId`
+ *   returns `tool.id`; `sdkToLogConverter` writes `sidechainId: toolUseId`). The UI cannot know which
+ *   run the CLI attached an agent to — a plain subagent is attached to a synthesized implicit run
+ *   only once a second one appears — so the merge joins on the handle and adopts the headline's id.
+ */
+/** The separator between an entry id's components. Part of the wire format. */
+export declare const AGENT_ACTIVITY_ENTRY_ID_SEPARATOR = ":";
+/**
+ * What an entry id names, in the vocabulary each producer already speaks.
+ *
+ * A member here is required for every kind on the wire — the prefix table below is typed
+ * `Record<AgentActivityKindV1, …>`, so a kind added to the union without an id shape fails to
+ * compile at the owner rather than at whichever caller happens to be compiled first.
+ */
+export type AgentActivityEntryRefV1 = Readonly<{
+    kind: 'workflow_run';
+    runId: string;
+}> | Readonly<{
+    kind: 'workflow_agent';
+    runId: string;
+    agentId: string;
+}>;
+/**
+ * Escape a component so the id splits into a fixed number of parts.
+ *
+ * Both variable components genuinely contain the separator in production, which is why this exists
+ * rather than a "components must not contain ':'" rule: the CLI's synthesized run id is literally
+ * `implicit:agent-activity`, and a workflow journal's fallback agent id is literally
+ * `workflow-agent:1` (OBSERVED in the recorded concurrent-workflow fixture). A scheme that forbade
+ * either would push the producer into either throwing on real data or minting an id that reads back
+ * as a different agent — which, joined on, merges two agents into one row or splits one into two.
+ *
+ * `%` is escaped first so the encoding is reversible.
+ */
+export declare function encodeAgentActivityIdComponent(value: string, label: string): string;
+export declare function buildAgentActivityEntryId(ref: AgentActivityEntryRefV1): string;
+/**
+ * Read an entry id back, or `null` when this build does not know the shape.
+ *
+ * `null` rather than a throw, and deliberately: a client one release behind a producer that has
+ * started publishing a new kind must degrade to "I cannot join this entry", never to a crash or to
+ * an empty roster (PLAN §5.2).
+ */
+export declare function parseAgentActivityEntryId(entryId: string): AgentActivityEntryRefV1 | null;
+/**
+ * The provider handle a headline entry and a locally derived entry can be joined on, or `null` when
+ * the entry is not agent-shaped.
+ *
+ * A run returns `null` on purpose. A run is the box its agents sit in, not a unit of work anybody
+ * derives locally, and handing back its run id would let it join onto an unrelated local row.
+ */
+export declare function resolveAgentActivityEntryAgentHandle(entryId: string): string | null;
+//# sourceMappingURL=agentActivityEntryId.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/agentActivityEntryId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentActivityEntryId.d.ts","sourceRoot":"","sources":["../../src/sessionAgentActivity/agentActivityEntryId.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,QAAQ,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOzE;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnF;AAMD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAiB9E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAmBzF;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAanF"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/agentActivityEntryId.js

@@ -0,0 +1,119 @@
+/**
+ * The one owner of how a unit of agent work is named.
+ *
+ * `deriveAgentActivityEntries` unions the headline the CLI publishes with the entries the UI derives
+ * from the transcript, and it unions them BY ID. Two spellings of one agent — `workflow_agent:wf_1:a1`
+ * on the producer against `wf_1/a1` on the consumer — therefore render that agent twice, with every
+ * schema valid, every test green and nothing failing loudly. That is the failure this module exists
+ * to make impossible: the CLI projection and the UI merge both import these functions, so there is
+ * one spelling by construction, and the hand-written literals in the test are the lock on it.
+ *
+ * Two separate identifiers live here, and conflating them is the subtle mistake:
+ *
+ * - **The entry id** is what a row is keyed by and what the headline publishes. It is namespaced by
+ *   the run an agent belongs to, because a provider agent id is only unique inside its run — a
+ *   recorded two-run workflow fixture labels an agent `workflow-agent:1` in BOTH of its runs.
+ * - **The agent handle** is the provider-side tool-use id underneath. It is the ONLY identifier the
+ *   two sides can independently produce for the same work: the CLI sees the SDK's `tool_use` id
+ *   (`claudeWorkflowCorrelation.parseSubagentToolUse` → the agent's snapshot id), and the UI sees the
+ *   transcript tool call whose id doubles as the sidechain id (`resolveToolTranscriptSidechainId`
+ *   returns `tool.id`; `sdkToLogConverter` writes `sidechainId: toolUseId`). The UI cannot know which
+ *   run the CLI attached an agent to — a plain subagent is attached to a synthesized implicit run
+ *   only once a second one appears — so the merge joins on the handle and adopts the headline's id.
+ */
+/** The separator between an entry id's components. Part of the wire format. */
+export const AGENT_ACTIVITY_ENTRY_ID_SEPARATOR = ':';
+const ENTRY_ID_PREFIX_BY_KIND = {
+    workflow_run: 'workflow_run',
+    workflow_agent: 'workflow_agent',
+};
+/**
+ * Escape a component so the id splits into a fixed number of parts.
+ *
+ * Both variable components genuinely contain the separator in production, which is why this exists
+ * rather than a "components must not contain ':'" rule: the CLI's synthesized run id is literally
+ * `implicit:agent-activity`, and a workflow journal's fallback agent id is literally
+ * `workflow-agent:1` (OBSERVED in the recorded concurrent-workflow fixture). A scheme that forbade
+ * either would push the producer into either throwing on real data or minting an id that reads back
+ * as a different agent — which, joined on, merges two agents into one row or splits one into two.
+ *
+ * `%` is escaped first so the encoding is reversible.
+ */
+export function encodeAgentActivityIdComponent(value, label) {
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        throw new Error(`agent-activity entry id: ${label} must be a non-empty string`);
+    }
+    return normalized
+        .replaceAll('%', '%25')
+        .replaceAll(AGENT_ACTIVITY_ENTRY_ID_SEPARATOR, '%3A');
+}
+function decodeIdComponent(value) {
+    return value.replaceAll('%3A', AGENT_ACTIVITY_ENTRY_ID_SEPARATOR).replaceAll('%25', '%');
+}
+export function buildAgentActivityEntryId(ref) {
+    const prefix = ENTRY_ID_PREFIX_BY_KIND[ref.kind];
+    switch (ref.kind) {
+        case 'workflow_run':
+            return [prefix, encodeAgentActivityIdComponent(ref.runId, 'runId')]
+                .join(AGENT_ACTIVITY_ENTRY_ID_SEPARATOR);
+        case 'workflow_agent':
+            return [
+                prefix,
+                encodeAgentActivityIdComponent(ref.runId, 'runId'),
+                encodeAgentActivityIdComponent(ref.agentId, 'agentId'),
+            ].join(AGENT_ACTIVITY_ENTRY_ID_SEPARATOR);
+        default: {
+            const exhaustive = ref;
+            return exhaustive;
+        }
+    }
+}
+/**
+ * Read an entry id back, or `null` when this build does not know the shape.
+ *
+ * `null` rather than a throw, and deliberately: a client one release behind a producer that has
+ * started publishing a new kind must degrade to "I cannot join this entry", never to a crash or to
+ * an empty roster (PLAN §5.2).
+ */
+export function parseAgentActivityEntryId(entryId) {
+    // Fixed arity, because every component is escaped: an id with a different part count was not
+    // written by this builder and this build must not guess at what it meant.
+    const parts = entryId.split(AGENT_ACTIVITY_ENTRY_ID_SEPARATOR);
+    const prefix = parts[0];
+    if (prefix === ENTRY_ID_PREFIX_BY_KIND.workflow_run && parts.length === 2) {
+        const runId = decodeIdComponent(parts[1]).trim();
+        return runId.length > 0 ? { kind: 'workflow_run', runId } : null;
+    }
+    if (prefix === ENTRY_ID_PREFIX_BY_KIND.workflow_agent && parts.length === 3) {
+        const runId = decodeIdComponent(parts[1]).trim();
+        const agentId = decodeIdComponent(parts[2]).trim();
+        if (runId.length === 0 || agentId.length === 0)
+            return null;
+        return { kind: 'workflow_agent', runId, agentId };
+    }
+    return null;
+}
+/**
+ * The provider handle a headline entry and a locally derived entry can be joined on, or `null` when
+ * the entry is not agent-shaped.
+ *
+ * A run returns `null` on purpose. A run is the box its agents sit in, not a unit of work anybody
+ * derives locally, and handing back its run id would let it join onto an unrelated local row.
+ */
+export function resolveAgentActivityEntryAgentHandle(entryId) {
+    const ref = parseAgentActivityEntryId(entryId);
+    if (ref === null)
+        return null;
+    switch (ref.kind) {
+        case 'workflow_agent':
+            return ref.agentId;
+        case 'workflow_run':
+            return null;
+        default: {
+            const exhaustive = ref;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=agentActivityEntryId.js.map

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/agentActivityEntryId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentActivityEntryId.js","sourceRoot":"","sources":["../../src/sessionAgentActivity/agentActivityEntryId.ts"],"names":[],"mappings":"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"}

package/node_modules/@happier-dev/protocol/dist/sessionAgentActivity/agentActivityEntryV1.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { type AgentActivityStatusV1 } from './agentActivityStatusV1.js';
+/**
+ * Longest title a headline entry may carry.
+ *
+ * The headline is published into session metadata, which is encrypted, synced and read on every
+ * cold open, so its size is a product cost paid by every client. A row renders one tail-truncated
+ * line, and the untruncated title lives in the durable record the entry points at, so a bound this
+ * generous is invisible in the UI and keeps a full roster in the low kilobytes. The workflow
+ * headline's 4000-character bound is inherited from its snapshot schema and is not a precedent for
+ * a per-entry roster.
+ */
+export declare const SESSION_AGENT_ACTIVITY_ENTRY_TITLE_MAX = 200;
+/**
+ * One unit of agent work, as the compact headline describes it.
+ *
+ * **A pointer, not a record.** Identity, kind, title, status, timing and the ids needed to find the
+ * real thing — and nothing else. No transcript, no preview, no summary, no payload, no counts
+ * copied off a child. Detail already lives somewhere durable and indexed (a sidechain is queryable
+ * by `sidechainId`; a workflow run has its `activity/workflow_run.v1` record), and a second copy in
+ * session metadata would be a second authority that can disagree with the first.
+ *
+ * Two fields carry hard-won rules:
+ *
+ * - `startedAt` is OPTIONAL and must never be synthesised. Defect D-8 shipped exactly that mistake
+ *   one layer up (`startedAtMs ?? updatedAtMs ?? finishedAtMs ?? 0`), so a finished 16-second run
+ *   reported `0:00`. Absent evidence of a start, the field is absent and the surface shows nothing.
+ * - `updatedAt` is the instant of the most recent EVIDENCE about this entry — not the instant the
+ *   producer last rebuilt it, and specifically not a launch timestamp that never advances. It feeds
+ *   terminal-history ordering here and the quiet/stale presentation downstream, both of which lie
+ *   if it stands still while the work does not.
+ */
+export declare const SessionAgentActivityEntryV1Schema: z.ZodObject<{
+    entryId: z.ZodString;
+    kind: z.ZodEnum<{
+        workflow_agent: "workflow_agent";
+        workflow_run: "workflow_run";
+    }>;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        cancelled: "cancelled";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        starting: "starting";
+        succeeded: "succeeded";
+        timedOut: "timedOut";
+        unknown: "unknown";
+        waiting: "waiting";
+    }>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    updatedAt: z.ZodNumber;
+    sidechainId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    recordRevision: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionAgentActivityEntryV1 = z.infer<typeof SessionAgentActivityEntryV1Schema>;
+/**
+ * Narrow an entry to the headline field set.
+ *
+ * The producer-side half of the "headline never holds detail" invariant: structural typing lets a
+ * caller pass a richer object, and this is the chokepoint that stops its extra fields reaching
+ * session metadata regardless. It also clamps the title, so a producer cannot emit an entry that
+ * its own schema would reject and that a reader would then silently drop.
+ */
+export declare function projectAgentActivityEntry(entry: SessionAgentActivityEntryV1): SessionAgentActivityEntryV1;
+/**
+ * Rank among ACTIVE entries; lower sorts first.
+ *
+ * `waiting` leads because it is the one status a person can clear right now — it is the only status
+ * in the vocabulary that escalates. Then dependency-blocked, then live work, then work that has been
+ * admitted but is not producing yet, then ambiguous. Terminal statuses sort last so that a caller
+ * who hands this comparator a mixed array cannot bury a live entry under finished ones; they never
+ * reach the active list through the builder.
+ */
+export declare function resolveAgentActivityEntryActivePriority(entry: Readonly<{
+    status: AgentActivityStatusV1;
+}>): number;
+//# sourceMappingURL=agentActivityEntryV1.d.ts.map