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

package/node_modules/@happier-dev/protocol/dist/sessionWorkState/sessionWorkStateV1.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+export const SessionWorkStateStatusV1Schema = z.enum([
+    'pending',
+    'active',
+    'paused',
+    'blocked',
+    'complete',
+    'cancelled',
+    'unknown',
+]);
+// Provider-neutral status reasons (additive, shared across providers):
+//  - `blocked`: provider reported a generic blocked state without a narrower reason (Codex).
+//  - `usageLimited`: provider usage limits currently prevent further work (Codex).
+//  - `budgetLimited`: goal paused/blocked because a token budget was reached (Codex).
+//  - `interrupted`: goal was left `active` when its CLI session tore down gracefully without the
+//    goal being met (G-6). Status stays `active` (the goal may resume); the reason lets the UI mark
+//    it "(interrupted)" and resume-injection distinguish it from a freshly-set goal.
+export const SessionWorkStateStatusReasonV1Schema = z.enum([
+    'blocked',
+    'usageLimited',
+    'budgetLimited',
+    'interrupted',
+]);
+export const SessionWorkStateItemKindV1Schema = z.enum(['goal', 'task', 'todo']);
+export const SessionWorkStateItemOriginV1Schema = z.enum(['vendor', 'happier', 'derived']);
+// Provider-derived goal capabilities. The owning provider computes these from its own
+// signals (Codex from app-server goal mode; Claude from observed `goal_status` + `/goal`
+// support) so generic UI gating stays capability-driven instead of branching on provider id.
+// All members optional + passthrough so the projection is additive and forward-compatible.
+export const SessionWorkStateGoalCapabilitiesV1Schema = z
+    .object({
+    canEdit: z.boolean().optional(),
+    canStop: z.boolean().optional(),
+    canClear: z.boolean().optional(),
+})
+    .passthrough();
+export const SessionWorkStateItemV1Schema = z
+    .object({
+    id: z.string().min(1),
+    kind: SessionWorkStateItemKindV1Schema,
+    origin: SessionWorkStateItemOriginV1Schema,
+    status: SessionWorkStateStatusV1Schema,
+    title: z.string().trim().min(1).max(4000),
+    summary: z.string().trim().max(8000).optional(),
+    backendId: z.string().min(1).optional(),
+    agentId: z.string().min(1).optional(),
+    vendorRef: z.string().min(1).optional(),
+    order: z.number().int().nonnegative().optional(),
+    parentId: z.string().min(1).optional(),
+    priority: z.string().optional(),
+    progress: z.number().finite().min(0).max(1).optional(),
+    statusReason: SessionWorkStateStatusReasonV1Schema.optional(),
+    goalCapabilities: SessionWorkStateGoalCapabilitiesV1Schema.optional(),
+    tokenBudget: z.number().finite().positive().nullable().optional(),
+    tokensUsed: z.number().int().nonnegative().optional(),
+    timeUsedSeconds: z.number().finite().nonnegative().optional(),
+    createdAt: z.number().int().nonnegative().optional(),
+    startedAt: z.number().int().nonnegative().optional(),
+    completedAt: z.number().int().nonnegative().optional(),
+    updatedAt: z.number().int().nonnegative(),
+})
+    .passthrough();
+export const SessionWorkStateTruncationV1Schema = z
+    .object({
+    reason: z.enum(['item_limit', 'provider_limit']),
+    omittedCount: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+export const SessionWorkStateV1Schema = z
+    .object({
+    v: z.literal(1),
+    backendId: z.string().min(1),
+    agentId: z.string().min(1).optional(),
+    updatedAt: z.number().int().nonnegative(),
+    items: z.array(SessionWorkStateItemV1Schema),
+    primaryItemId: z.string().min(1).nullable().optional(),
+    truncated: SessionWorkStateTruncationV1Schema.optional(),
+})
+    .passthrough();
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function readNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
+}
+function readNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function readPrimaryItemId(value) {
+    if (value === null)
+        return null;
+    const primaryItemId = readNonEmptyString(value);
+    return primaryItemId ?? undefined;
+}
+export function readDisplayableSessionWorkStateV1(value) {
+    const record = asRecord(value);
+    if (!record || record.v !== 1)
+        return null;
+    const backendId = readNonEmptyString(record.backendId);
+    const updatedAt = readNonNegativeInteger(record.updatedAt);
+    if (!backendId || updatedAt === null || !Array.isArray(record.items))
+        return null;
+    const displayableItems = record.items.flatMap((item) => {
+        const parsed = SessionWorkStateItemV1Schema.safeParse(item);
+        return parsed.success ? [parsed.data] : [];
+    });
+    if (record.items.length > 0 && displayableItems.length === 0)
+        return null;
+    const agentId = readNonEmptyString(record.agentId);
+    const primaryItemId = readPrimaryItemId(record.primaryItemId);
+    const truncated = SessionWorkStateTruncationV1Schema.safeParse(record.truncated);
+    const { agentId: _agentId, backendId: _backendId, items: _items, primaryItemId: _primaryItemId, truncated: _truncated, updatedAt: _updatedAt, v: _v, ...passthrough } = record;
+    return {
+        ...passthrough,
+        v: 1,
+        backendId,
+        ...(agentId ? { agentId } : {}),
+        updatedAt,
+        items: displayableItems,
+        ...(primaryItemId !== undefined ? { primaryItemId } : {}),
+        ...(truncated.success ? { truncated: truncated.data } : {}),
+    };
+}
+//# sourceMappingURL=sessionWorkStateV1.js.map

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

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

package/node_modules/@happier-dev/protocol/dist/sessionWorkState/skillCatalogItemIdentityV1.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The canonical identity of a skill catalog item (D-23, derived in EU-D0).
+ *
+ * A skill is identified by the tuple `(origin, backendId, projectionRef, name)`, materialized
+ * as one string. `path` is deliberately NOT part of it: a path is worktree- and machine-local,
+ * so embedding it in a persisted reference would make the reference go stale (D-3/INV-9).
+ *
+ * This is a byte-for-byte port of `../dev`'s
+ * `packages/protocol/src/runtime/catalog/skills.ts` derivation, including its legacy-origin
+ * folding. The two repositories must agree exactly: a `happier.skill` reference is persisted
+ * and transmitted, so a reference written by one repository is resolved by the other.
+ */
+/**
+ * The legacy origin vocabulary, declared ONCE. The catalog wire schema derives its legacy
+ * arm from this list (`sessionWorkStateRpc.ts`) instead of re-listing the literals, so an
+ * origin the schema accepts is always one this module can fold to a canonical identity.
+ */
+export declare const LEGACY_SKILL_CATALOG_ORIGINS_V1: readonly [string, ...string[]];
+export type SkillCatalogOriginV1 = 'vendor' | 'happier';
+export type SkillCatalogItemIdentityV1 = Readonly<{
+    id: string;
+    origin: SkillCatalogOriginV1;
+    name: string;
+    backendId: string | null;
+    projectionRef: string | null;
+}>;
+/**
+ * Returns `null` when the item carries no usable identity — a missing name, a missing origin,
+ * or an origin outside the canonical and legacy sets. An unidentifiable catalog item can never
+ * be the target of a reference, so it is skipped rather than guessed at.
+ */
+export declare function resolveSkillCatalogItemIdentityV1(value: unknown): SkillCatalogItemIdentityV1 | null;
+//# sourceMappingURL=skillCatalogItemIdentityV1.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionWorkState/skillCatalogItemIdentityV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCatalogItemIdentityV1.d.ts","sourceRoot":"","sources":["../../src/sessionWorkState/skillCatalogItemIdentityV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAGlB,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAcxD,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,IAAI,CA6BnG"}

package/node_modules/@happier-dev/protocol/dist/sessionWorkState/skillCatalogItemIdentityV1.js

@@ -0,0 +1,73 @@
+/**
+ * The canonical identity of a skill catalog item (D-23, derived in EU-D0).
+ *
+ * A skill is identified by the tuple `(origin, backendId, projectionRef, name)`, materialized
+ * as one string. `path` is deliberately NOT part of it: a path is worktree- and machine-local,
+ * so embedding it in a persisted reference would make the reference go stale (D-3/INV-9).
+ *
+ * This is a byte-for-byte port of `../dev`'s
+ * `packages/protocol/src/runtime/catalog/skills.ts` derivation, including its legacy-origin
+ * folding. The two repositories must agree exactly: a `happier.skill` reference is persisted
+ * and transmitted, so a reference written by one repository is resolved by the other.
+ */
+const LEGACY_VENDOR_SKILL_BACKENDS = {
+    codex_native: 'codex',
+    opencode_native: 'opencode',
+    claude_native: 'claude',
+    pi_native: 'pi',
+};
+const LEGACY_HAPPIER_SKILL_ORIGINS = ['happier_projected', 'text_fallback_only'];
+/**
+ * The legacy origin vocabulary, declared ONCE. The catalog wire schema derives its legacy
+ * arm from this list (`sessionWorkStateRpc.ts`) instead of re-listing the literals, so an
+ * origin the schema accepts is always one this module can fold to a canonical identity.
+ */
+export const LEGACY_SKILL_CATALOG_ORIGINS_V1 = [
+    ...Object.keys(LEGACY_VENDOR_SKILL_BACKENDS),
+    ...LEGACY_HAPPIER_SKILL_ORIGINS,
+];
+function readString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function readLegacyVendorBackend(origin) {
+    return Object.prototype.hasOwnProperty.call(LEGACY_VENDOR_SKILL_BACKENDS, origin)
+        ? LEGACY_VENDOR_SKILL_BACKENDS[origin]
+        : null;
+}
+/**
+ * Returns `null` when the item carries no usable identity — a missing name, a missing origin,
+ * or an origin outside the canonical and legacy sets. An unidentifiable catalog item can never
+ * be the target of a reference, so it is skipped rather than guessed at.
+ */
+export function resolveSkillCatalogItemIdentityV1(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const item = value;
+    const name = readString(item.name);
+    const rawOrigin = readString(item.origin);
+    if (!name || !rawOrigin)
+        return null;
+    const legacyBackendId = readLegacyVendorBackend(rawOrigin);
+    const origin = rawOrigin === 'vendor' || rawOrigin === 'happier'
+        ? rawOrigin
+        : legacyBackendId
+            ? 'vendor'
+            : LEGACY_HAPPIER_SKILL_ORIGINS.includes(rawOrigin)
+                ? 'happier'
+                : null;
+    if (!origin)
+        return null;
+    const backendId = readString(item.backendId) ?? legacyBackendId;
+    const projectionRef = readString(item.projectionRef)
+        ?? readString(item.projectionKind)
+        ?? (origin === 'happier' && rawOrigin !== 'happier' ? rawOrigin : null);
+    const id = readString(item.id)
+        ?? [origin, backendId, projectionRef, name]
+            .filter((part) => typeof part === 'string' && part.length > 0)
+            .join(':');
+    return { id, origin, name, backendId, projectionRef };
+}
+//# sourceMappingURL=skillCatalogItemIdentityV1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillCatalogItemIdentityV1.js","sourceRoot":"","sources":["../../src/sessionWorkState/skillCatalogItemIdentityV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,4BAA4B,GAAG;IACnC,YAAY,EAAE,OAAO;IACrB,eAAe,EAAE,UAAU;IAC3B,aAAa,EAAE,QAAQ;IACvB,SAAS,EAAE,IAAI;CACP,CAAC;AAEX,MAAM,4BAA4B,GAAG,CAAC,mBAAmB,EAAE,oBAAoB,CAAU,CAAC;AAE1F;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,GAAG,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC;IAC5C,GAAG,4BAA4B;CACuB,CAAC;AAIzD,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,4BAA4B,EAAE,MAAM,CAAC;QAC/E,CAAC,CAAC,4BAA4B,CAAC,MAAmD,CAAC;QACnF,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAE9C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,eAAe,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAgC,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS;QAC3F,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe;YACf,CAAC,CAAC,QAAQ;YACV,CAAC,CAAE,4BAAkD,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACvE,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC;IAChE,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;WAC/C,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC;WAC/B,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE1E,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;WACzB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;aACxC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aAC7E,IAAI,CAAC,GAAG,CAAC,CAAC;IAEf,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,6 @@
+export { SESSION_WORKFLOW_RUN_SNAPSHOT_RESULT_PREVIEW_MAX, SESSION_WORKFLOW_RUN_SNAPSHOT_PROJECTION_VERSION, SESSION_WORKFLOW_RUN_SNAPSHOT_SUMMARY_MAX, SESSION_WORKFLOW_RUN_SNAPSHOT_TITLE_MAX, SessionWorkflowAgentSnapshotV1Schema, SessionWorkflowAgentStatusV1Schema, SessionWorkflowPhaseSnapshotV1Schema, SessionWorkflowRunSnapshotV1Schema, SessionWorkflowRunStatusReasonV1Schema, SessionWorkflowRunStatusV1Schema, type SessionWorkflowAgentSnapshotV1, type SessionWorkflowAgentStatusV1, type SessionWorkflowPhaseSnapshotV1, type SessionWorkflowRunSnapshotV1, type SessionWorkflowRunStatusReasonV1, type SessionWorkflowRunStatusV1, } from './sessionWorkflowRunSnapshotV1.js';
+export { findWorkflowPhaseForAgent, resolveWorkflowAgentPhaseTitle, } from './sessionWorkflowPhases.js';
+export { SessionWorkflowActivityHeadlineTruncationV1Schema, SessionWorkflowActivityHeadlineV1Schema, SessionWorkflowRunHeadlineV1Schema, type SessionWorkflowActivityHeadlineTruncationV1, type SessionWorkflowActivityHeadlineV1, type SessionWorkflowRunHeadlineV1, } from './sessionWorkflowActivityHeadlineV1.js';
+export { SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT, boundRecentWorkflowRunHeadlines, buildSessionWorkflowActivityHeadline, isTerminalWorkflowRunStatus, resolvePrimaryWorkflowRunId, sortActiveWorkflowRunHeadlines, type BuildSessionWorkflowActivityHeadlineInput, } from './sessionWorkflowActivityHeadlineBuild.js';
+export { bumpWorkflowRunRecordRevision, isWorkflowRunSnapshotMaterialChange, } from './sessionWorkflowRunRecordRevision.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gDAAgD,EAChD,gDAAgD,EAChD,yCAAyC,EACzC,uCAAuC,EACvC,oCAAoC,EACpC,kCAAkC,EAClC,oCAAoC,EACpC,kCAAkC,EAClC,sCAAsC,EACtC,gCAAgC,EAChC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,GAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iDAAiD,EACjD,uCAAuC,EACvC,kCAAkC,EAClC,KAAK,2CAA2C,EAChD,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,GAClC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,2CAA2C,EAC3C,+BAA+B,EAC/B,oCAAoC,EACpC,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,KAAK,yCAAyC,GAC/C,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,GACpC,MAAM,uCAAuC,CAAC"}

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

@@ -0,0 +1,6 @@
+export { SESSION_WORKFLOW_RUN_SNAPSHOT_RESULT_PREVIEW_MAX, SESSION_WORKFLOW_RUN_SNAPSHOT_PROJECTION_VERSION, SESSION_WORKFLOW_RUN_SNAPSHOT_SUMMARY_MAX, SESSION_WORKFLOW_RUN_SNAPSHOT_TITLE_MAX, SessionWorkflowAgentSnapshotV1Schema, SessionWorkflowAgentStatusV1Schema, SessionWorkflowPhaseSnapshotV1Schema, SessionWorkflowRunSnapshotV1Schema, SessionWorkflowRunStatusReasonV1Schema, SessionWorkflowRunStatusV1Schema, } from './sessionWorkflowRunSnapshotV1.js';
+export { findWorkflowPhaseForAgent, resolveWorkflowAgentPhaseTitle, } from './sessionWorkflowPhases.js';
+export { SessionWorkflowActivityHeadlineTruncationV1Schema, SessionWorkflowActivityHeadlineV1Schema, SessionWorkflowRunHeadlineV1Schema, } from './sessionWorkflowActivityHeadlineV1.js';
+export { SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT, boundRecentWorkflowRunHeadlines, buildSessionWorkflowActivityHeadline, isTerminalWorkflowRunStatus, resolvePrimaryWorkflowRunId, sortActiveWorkflowRunHeadlines, } from './sessionWorkflowActivityHeadlineBuild.js';
+export { bumpWorkflowRunRecordRevision, isWorkflowRunSnapshotMaterialChange, } from './sessionWorkflowRunRecordRevision.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gDAAgD,EAChD,gDAAgD,EAChD,yCAAyC,EACzC,uCAAuC,EACvC,oCAAoC,EACpC,kCAAkC,EAClC,oCAAoC,EACpC,kCAAkC,EAClC,sCAAsC,EACtC,gCAAgC,GAOjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iDAAiD,EACjD,uCAAuC,EACvC,kCAAkC,GAInC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,2CAA2C,EAC3C,+BAA+B,EAC/B,oCAAoC,EACpC,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,GAE/B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,GACpC,MAAM,uCAAuC,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineBuild.d.ts

@@ -0,0 +1,44 @@
+import type { SessionWorkflowActivityHeadlineTruncationV1, SessionWorkflowActivityHeadlineV1, SessionWorkflowRunHeadlineV1 } from './sessionWorkflowActivityHeadlineV1.js';
+import type { SessionWorkflowRunStatusV1 } from './sessionWorkflowRunSnapshotV1.js';
+/**
+ * Default terminal-history bound for the compact metadata headline. Only `recentRuns` is
+ * bounded; `activeRuns` is never capped because active concurrency is provider behavior, not
+ * a Happier-imposed limit. Terminal `activity/workflow_run.v1` records remain durable history.
+ */
+export declare const SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT = 5;
+export declare function isTerminalWorkflowRunStatus(status: SessionWorkflowRunStatusV1): boolean;
+/** Deterministic active-run ordering shared by every client so they agree on `primaryRunId`. */
+export declare function sortActiveWorkflowRunHeadlines(runs: readonly SessionWorkflowRunHeadlineV1[]): SessionWorkflowRunHeadlineV1[];
+/**
+ * `primaryRunId` is a derived hint, not a second source of truth. It is `null` when there are
+ * no active runs; otherwise it is the first run after deterministic active-run sorting.
+ */
+export declare function resolvePrimaryWorkflowRunId(activeRuns: readonly SessionWorkflowRunHeadlineV1[]): string | null;
+/** Bound only terminal history; never bound active concurrency. */
+export declare function boundRecentWorkflowRunHeadlines(terminalRuns: readonly SessionWorkflowRunHeadlineV1[], limit?: number): {
+    recentRuns: SessionWorkflowRunHeadlineV1[];
+    truncated?: SessionWorkflowActivityHeadlineTruncationV1;
+};
+/**
+ * Project a run to the count-only headline field set. The producer guards the
+ * "headline never holds workflow detail" invariant here (§3.3): a caller passing a
+ * detail-bearing snapshot object can never leak phases/agents/previews into the compact
+ * session-metadata headline, regardless of structural typing. Pairs with the strip-by-default
+ * schema for defence in depth.
+ */
+export declare function projectWorkflowRunHeadline(run: SessionWorkflowRunHeadlineV1): SessionWorkflowRunHeadlineV1;
+export type BuildSessionWorkflowActivityHeadlineInput = Readonly<{
+    backendId: string;
+    agentId?: string;
+    updatedAt: number;
+    runs: readonly SessionWorkflowRunHeadlineV1[];
+    recentRunsLimit?: number;
+}>;
+/**
+ * Build the compact headline from a flat list of run headlines. Partitions active vs terminal
+ * runs, keeps every active run, bounds terminal history, and computes a deterministic
+ * `primaryRunId`. This is the single shared builder reused by the publisher and ported to
+ * `../dev`, so multiple clients agree on ordering and primary selection.
+ */
+export declare function buildSessionWorkflowActivityHeadline(input: BuildSessionWorkflowActivityHeadlineInput): SessionWorkflowActivityHeadlineV1;
+//# sourceMappingURL=sessionWorkflowActivityHeadlineBuild.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWorkflowActivityHeadlineBuild.d.ts","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/sessionWorkflowActivityHeadlineBuild.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,2CAA2C,EAC3C,iCAAiC,EACjC,4BAA4B,EAC7B,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,2CAA2C,IAAI,CAAC;AAS7D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAEvF;AAgCD,gGAAgG;AAChG,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,SAAS,4BAA4B,EAAE,GAC5C,4BAA4B,EAAE,CAEhC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS,4BAA4B,EAAE,GAClD,MAAM,GAAG,IAAI,CAGf;AAED,mEAAmE;AACnE,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,SAAS,4BAA4B,EAAE,EACrD,KAAK,GAAE,MAAoD,GAC1D;IAAE,UAAU,EAAE,4BAA4B,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,2CAA2C,CAAA;CAAE,CAUzG;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,4BAA4B,GAAG,4BAA4B,CAgB1G;AAED,MAAM,MAAM,yCAAyC,GAAG,QAAQ,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,iCAAiC,CAqBnC"}

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineBuild.js

@@ -0,0 +1,123 @@
+import { boundRecentActivityHeadlineEntries, partitionActivityHeadlineEntries, sortActiveActivityHeadlineEntries, } from '../sessionActivityHeadlineOrdering.js';
+/**
+ * Default terminal-history bound for the compact metadata headline. Only `recentRuns` is
+ * bounded; `activeRuns` is never capped because active concurrency is provider behavior, not
+ * a Happier-imposed limit. Terminal `activity/workflow_run.v1` records remain durable history.
+ */
+export const SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT = 5;
+const TERMINAL_WORKFLOW_RUN_STATUSES = new Set([
+    'complete',
+    'failed',
+    'stopped',
+    'cancelled',
+]);
+export function isTerminalWorkflowRunStatus(status) {
+    return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);
+}
+// Active-run attention priority: runs needing user attention (blocked) first, then active,
+// then pending/unknown. Run statuses do not include a literal `pending`, but the comparator
+// keeps that tier so the rule stays stable if a provider ever surfaces one. Ordinary progress
+// timestamps intentionally do NOT participate in active ordering: workflows update frequently, and
+// sorting by `updatedAt` makes the compact badge and popover reorder on every progress tick.
+function activeRunStatusPriority(status) {
+    switch (status) {
+        case 'blocked':
+            return 0;
+        case 'active':
+            return 1;
+        case 'pending':
+            return 2;
+        default:
+            return 3;
+    }
+}
+/**
+ * How the shared headline-ordering owner reads a workflow run. Ordering, bounding and the
+ * "progress timestamps never touch the active side" rule live in
+ * `../sessionActivityHeadlineOrdering.ts`, which the agent-activity headline also calls — this
+ * module contributes only the workflow vocabulary's terminality, priority and projection.
+ */
+const WORKFLOW_RUN_HEADLINE_ACCESSORS = {
+    id: (run) => run.runId,
+    activePriority: (run) => activeRunStatusPriority(run.status),
+    updatedAt: (run) => run.updatedAt,
+};
+/** Deterministic active-run ordering shared by every client so they agree on `primaryRunId`. */
+export function sortActiveWorkflowRunHeadlines(runs) {
+    return sortActiveActivityHeadlineEntries(runs, WORKFLOW_RUN_HEADLINE_ACCESSORS);
+}
+/**
+ * `primaryRunId` is a derived hint, not a second source of truth. It is `null` when there are
+ * no active runs; otherwise it is the first run after deterministic active-run sorting.
+ */
+export function resolvePrimaryWorkflowRunId(activeRuns) {
+    const sorted = sortActiveWorkflowRunHeadlines(activeRuns);
+    return sorted[0]?.runId ?? null;
+}
+/** Bound only terminal history; never bound active concurrency. */
+export function boundRecentWorkflowRunHeadlines(terminalRuns, limit = SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT) {
+    const { recent, omittedCount } = boundRecentActivityHeadlineEntries(terminalRuns, WORKFLOW_RUN_HEADLINE_ACCESSORS, limit);
+    if (omittedCount > 0) {
+        return { recentRuns: recent, truncated: { reason: 'run_limit', omittedCount } };
+    }
+    return { recentRuns: recent };
+}
+/**
+ * Project a run to the count-only headline field set. The producer guards the
+ * "headline never holds workflow detail" invariant here (§3.3): a caller passing a
+ * detail-bearing snapshot object can never leak phases/agents/previews into the compact
+ * session-metadata headline, regardless of structural typing. Pairs with the strip-by-default
+ * schema for defence in depth.
+ */
+export function projectWorkflowRunHeadline(run) {
+    const projected = {
+        runId: run.runId,
+        title: run.title,
+        status: run.status,
+        updatedAt: run.updatedAt,
+        recordRevision: run.recordRevision,
+        recordUpdatedAt: run.recordUpdatedAt,
+        totalAgents: run.totalAgents,
+        completedAgents: run.completedAgents,
+    };
+    if (run.statusReason !== undefined)
+        projected.statusReason = run.statusReason;
+    if (run.workflowToolUseId !== undefined)
+        projected.workflowToolUseId = run.workflowToolUseId;
+    if (run.failedAgents !== undefined)
+        projected.failedAgents = run.failedAgents;
+    if (run.blockedAgents !== undefined)
+        projected.blockedAgents = run.blockedAgents;
+    return projected;
+}
+/**
+ * Build the compact headline from a flat list of run headlines. Partitions active vs terminal
+ * runs, keeps every active run, bounds terminal history, and computes a deterministic
+ * `primaryRunId`. This is the single shared builder reused by the publisher and ported to
+ * `../dev`, so multiple clients agree on ordering and primary selection.
+ */
+export function buildSessionWorkflowActivityHeadline(input) {
+    const { active: activeRuns, recent: recentRuns, omittedCount } = partitionActivityHeadlineEntries({
+        entries: input.runs,
+        accessors: WORKFLOW_RUN_HEADLINE_ACCESSORS,
+        isTerminal: (run) => isTerminalWorkflowRunStatus(run.status),
+        // Project at the single producer chokepoint so detail can never reach the headline.
+        project: projectWorkflowRunHeadline,
+        recentLimit: input.recentRunsLimit ?? SESSION_WORKFLOW_ACTIVITY_RECENT_RUNS_LIMIT,
+    });
+    const headline = {
+        v: 1,
+        backendId: input.backendId,
+        updatedAt: input.updatedAt,
+        primaryRunId: activeRuns[0]?.runId ?? null,
+        activeRuns,
+    };
+    if (input.agentId)
+        headline.agentId = input.agentId;
+    if (recentRuns.length > 0)
+        headline.recentRuns = recentRuns;
+    if (omittedCount > 0)
+        headline.truncated = { reason: 'run_limit', omittedCount };
+    return headline;
+}
+//# sourceMappingURL=sessionWorkflowActivityHeadlineBuild.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWorkflowActivityHeadlineBuild.js","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/sessionWorkflowActivityHeadlineBuild.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,GAElC,MAAM,uCAAuC,CAAC;AAQ/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC;AAE7D,MAAM,8BAA8B,GAA4C,IAAI,GAAG,CAAC;IACtF,UAAU;IACV,QAAQ;IACR,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CAAC,MAAkC;IAC5E,OAAO,8BAA8B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,2FAA2F;AAC3F,4FAA4F;AAC5F,8FAA8F;AAC9F,mGAAmG;AACnG,6FAA6F;AAC7F,SAAS,uBAAuB,CAAC,MAA8C;IAC7E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,+BAA+B,GAAiE;IACpG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC;IAC5D,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS;CAClC,CAAC;AAEF,gGAAgG;AAChG,MAAM,UAAU,8BAA8B,CAC5C,IAA6C;IAE7C,OAAO,iCAAiC,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAmD;IAEnD,MAAM,MAAM,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,+BAA+B,CAC7C,YAAqD,EACrD,KAAK,GAAW,2CAA2C;IAE3D,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,kCAAkC,CACjE,YAAY,EACZ,+BAA+B,EAC/B,KAAK,CACN,CAAC;IACF,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAiC;IAC1E,MAAM,SAAS,GAAiC;QAC9C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;KACrC,CAAC;IACF,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,SAAS,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC9E,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAAE,SAAS,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAC7F,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,SAAS,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC9E,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;QAAE,SAAS,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IACjF,OAAO,SAAS,CAAC;AACnB,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAClD,KAAgD;IAEhD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,gCAAgC,CAAC;QAChG,OAAO,EAAE,KAAK,CAAC,IAAI;QACnB,SAAS,EAAE,+BAA+B;QAC1C,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5D,oFAAoF;QACpF,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,KAAK,CAAC,eAAe,IAAI,2CAA2C;KAClF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAsC;QAClD,CAAC,EAAE,CAAC;QACJ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;QAC1C,UAAU;KACX,CAAC;IACF,IAAI,KAAK,CAAC,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAC5D,IAAI,YAAY,GAAG,CAAC;QAAE,QAAQ,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;IACjF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineV1.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+/**
+ * Compact, count-only headline for one workflow run.
+ *
+ * The headline is a derived live pointer published into session metadata. It carries only
+ * the fields needed for compact UI display + cache invalidation: ids, title, status, exact
+ * counts, and the durable-record pointer (`recordRevision`/`recordUpdatedAt`). Phase/agent
+ * trees, previews, metrics, and raw payloads live only in the `activity/workflow_run.v1`
+ * system record — never here.
+ */
+export declare const SessionWorkflowRunHeadlineV1Schema: z.ZodObject<{
+    runId: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        blocked: "blocked";
+        cancelled: "cancelled";
+        complete: "complete";
+        failed: "failed";
+        stopped: "stopped";
+        unknown: "unknown";
+    }>;
+    statusReason: z.ZodOptional<z.ZodEnum<{
+        interrupted: "interrupted";
+    }>>;
+    workflowToolUseId: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodNumber;
+    recordRevision: z.ZodString;
+    recordUpdatedAt: z.ZodNumber;
+    totalAgents: z.ZodNumber;
+    completedAgents: z.ZodNumber;
+    failedAgents: z.ZodOptional<z.ZodNumber>;
+    blockedAgents: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SessionWorkflowRunHeadlineV1 = z.infer<typeof SessionWorkflowRunHeadlineV1Schema>;
+export declare const SessionWorkflowActivityHeadlineTruncationV1Schema: z.ZodObject<{
+    reason: z.ZodLiteral<"run_limit">;
+    omittedCount: z.ZodNumber;
+}, z.core.$strip>;
+export type SessionWorkflowActivityHeadlineTruncationV1 = z.infer<typeof SessionWorkflowActivityHeadlineTruncationV1Schema>;
+export declare const SessionWorkflowActivityHeadlineV1Schema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    backendId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodNumber;
+    primaryRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    activeRuns: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            blocked: "blocked";
+            cancelled: "cancelled";
+            complete: "complete";
+            failed: "failed";
+            stopped: "stopped";
+            unknown: "unknown";
+        }>;
+        statusReason: z.ZodOptional<z.ZodEnum<{
+            interrupted: "interrupted";
+        }>>;
+        workflowToolUseId: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodNumber;
+        recordRevision: z.ZodString;
+        recordUpdatedAt: z.ZodNumber;
+        totalAgents: z.ZodNumber;
+        completedAgents: z.ZodNumber;
+        failedAgents: z.ZodOptional<z.ZodNumber>;
+        blockedAgents: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    recentRuns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            blocked: "blocked";
+            cancelled: "cancelled";
+            complete: "complete";
+            failed: "failed";
+            stopped: "stopped";
+            unknown: "unknown";
+        }>;
+        statusReason: z.ZodOptional<z.ZodEnum<{
+            interrupted: "interrupted";
+        }>>;
+        workflowToolUseId: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodNumber;
+        recordRevision: z.ZodString;
+        recordUpdatedAt: z.ZodNumber;
+        totalAgents: z.ZodNumber;
+        completedAgents: z.ZodNumber;
+        failedAgents: z.ZodOptional<z.ZodNumber>;
+        blockedAgents: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodLiteral<"run_limit">;
+        omittedCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionWorkflowActivityHeadlineV1 = z.infer<typeof SessionWorkflowActivityHeadlineV1Schema>;
+//# sourceMappingURL=sessionWorkflowActivityHeadlineV1.d.ts.map

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWorkflowActivityHeadlineV1.d.ts","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/sessionWorkflowActivityHeadlineV1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;;;;GAQG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;iBAiBrC,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,iDAAiD;;;iBAKpD,CAAC;AACX,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iDAAiD,CAAC,CAAC;AAE5H,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW1C,CAAC;AACX,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC"}

package/node_modules/@happier-dev/protocol/dist/sessionWorkflowActivity/sessionWorkflowActivityHeadlineV1.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { SESSION_WORKFLOW_RUN_SNAPSHOT_TITLE_MAX, SessionWorkflowRunStatusReasonV1Schema, SessionWorkflowRunStatusV1Schema, } from './sessionWorkflowRunSnapshotV1.js';
+import { SESSION_WORKFLOW_RUN_RECORD_REVISION_PATTERN } from './sessionWorkflowRunRecordRevision.js';
+/**
+ * Compact, count-only headline for one workflow run.
+ *
+ * The headline is a derived live pointer published into session metadata. It carries only
+ * the fields needed for compact UI display + cache invalidation: ids, title, status, exact
+ * counts, and the durable-record pointer (`recordRevision`/`recordUpdatedAt`). Phase/agent
+ * trees, previews, metrics, and raw payloads live only in the `activity/workflow_run.v1`
+ * system record — never here.
+ */
+export const SessionWorkflowRunHeadlineV1Schema = z
+    .object({
+    runId: z.string().trim().min(1),
+    title: z.string().trim().min(1).max(SESSION_WORKFLOW_RUN_SNAPSHOT_TITLE_MAX),
+    status: SessionWorkflowRunStatusV1Schema,
+    statusReason: SessionWorkflowRunStatusReasonV1Schema.optional(),
+    workflowToolUseId: z.string().trim().min(1).optional(),
+    updatedAt: z.number().int().nonnegative(),
+    recordRevision: z.string().trim().regex(SESSION_WORKFLOW_RUN_RECORD_REVISION_PATTERN),
+    recordUpdatedAt: z.number().int().nonnegative(),
+    totalAgents: z.number().int().nonnegative(),
+    completedAgents: z.number().int().nonnegative(),
+    failedAgents: z.number().int().nonnegative().optional(),
+    blockedAgents: z.number().int().nonnegative().optional(),
+})
+    // Strip unknown keys (Zod default): the headline is a count-only pointer, so any leaked
+    // phase/agent/preview detail is dropped on parse. Forward-compat fields are added explicitly.
+    .strip();
+export const SessionWorkflowActivityHeadlineTruncationV1Schema = z
+    .object({
+    reason: z.literal('run_limit'),
+    omittedCount: z.number().int().nonnegative(),
+})
+    .strip();
+export const SessionWorkflowActivityHeadlineV1Schema = z
+    .object({
+    v: z.literal(1),
+    backendId: z.string().trim().min(1),
+    agentId: z.string().trim().min(1).optional(),
+    updatedAt: z.number().int().nonnegative(),
+    primaryRunId: z.string().trim().min(1).nullable().optional(),
+    activeRuns: z.array(SessionWorkflowRunHeadlineV1Schema),
+    recentRuns: z.array(SessionWorkflowRunHeadlineV1Schema).optional(),
+    truncated: SessionWorkflowActivityHeadlineTruncationV1Schema.optional(),
+})
+    .strip();
+//# sourceMappingURL=sessionWorkflowActivityHeadlineV1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWorkflowActivityHeadlineV1.js","sourceRoot":"","sources":["../../src/sessionWorkflowActivity/sessionWorkflowActivityHeadlineV1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uCAAuC,EACvC,sCAAsC,EACtC,gCAAgC,GACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,4CAA4C,EAAE,MAAM,uCAAuC,CAAC;AAErG;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,uCAAuC,CAAC;IAC5E,MAAM,EAAE,gCAAgC;IACxC,YAAY,EAAE,sCAAsC,CAAC,QAAQ,EAAE;IAC/D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,4CAA4C,CAAC;IACrF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC;IACF,wFAAwF;IACxF,8FAA8F;KAC7F,KAAK,EAAE,CAAC;AAGX,MAAM,CAAC,MAAM,iDAAiD,GAAG,CAAC;KAC/D,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC7C,CAAC;KACD,KAAK,EAAE,CAAC;AAGX,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC;KACrD,MAAM,CAAC;IACN,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,QAAQ,EAAE;IAClE,SAAS,EAAE,iDAAiD,CAAC,QAAQ,EAAE;CACxE,CAAC;KACD,KAAK,EAAE,CAAC"}