@cats-inc/cats-platform 0.1.0

package/build/server/products/work/shared/workGraphProjection.js

@@ -0,0 +1,189 @@
+/** Composite endpoint key, the form used everywhere SPEC-090 indexes by Core identity. */
+export function endpointKey(ref) {
+    return `${ref.recordFamily}:${ref.recordId}`;
+}
+/**
+ * Derive SPEC-090 read-side link views, orphan diagnostics, and cycle
+ * diagnostics from the raw stored `links`. Mirrors §FR5 / §FR7 / §FR8
+ * exactly:
+ *
+ * - Both endpoints must resolve via `objectsByCoreRef`. Otherwise the row
+ *   is excluded from `linksByEndpoint` and surfaced as `orphan_link` only.
+ * - Per-row view emission:
+ *     blocks       → blocks view on source, blocked_by view on target
+ *     related_to   → related_to views on both endpoints
+ *     duplicate_of → duplicate_of view on source only
+ *     follows      → follows view on source only
+ * - Cycle detection runs on the well-resolved `blocks` subgraph only.
+ */
+export function projectLinks(links, objectsByCoreRef) {
+    const linksByEndpoint = {};
+    const diagnostics = [];
+    function pushView(key, view) {
+        const list = linksByEndpoint[key] ?? [];
+        list.push(view);
+        linksByEndpoint[key] = list;
+    }
+    const resolvedRows = [];
+    for (const link of links) {
+        const sourceRef = {
+            recordFamily: link.sourceRecordFamily,
+            recordId: link.sourceRecordId,
+        };
+        const targetRef = {
+            recordFamily: link.targetRecordFamily,
+            recordId: link.targetRecordId,
+        };
+        const sourceKey = endpointKey(sourceRef);
+        const targetKey = endpointKey(targetRef);
+        const sourceResolved = objectsByCoreRef.has(sourceKey);
+        const targetResolved = objectsByCoreRef.has(targetKey);
+        if (!sourceResolved || !targetResolved) {
+            const unresolvedSide = !sourceResolved && !targetResolved
+                ? "both"
+                : !sourceResolved
+                    ? "source"
+                    : "target";
+            diagnostics.push({
+                id: `diag-orphan-${link.id}`,
+                severity: "warning",
+                category: "lineage",
+                kind: "orphan_link",
+                objectId: null,
+                message: `Link ${link.id} (${link.kind}) references a record that does not resolve.`,
+                linkId: link.id,
+                sourceEndpoint: sourceRef,
+                targetEndpoint: targetRef,
+                unresolvedSide,
+            });
+            continue;
+        }
+        resolvedRows.push({ link, sourceRef, targetRef });
+        const baseView = {
+            linkId: link.id,
+            note: link.note,
+            createdAt: link.createdAt,
+        };
+        switch (link.kind) {
+            case "blocks":
+                pushView(sourceKey, {
+                    ...baseView,
+                    kind: "blocks",
+                    selfEndpoint: sourceRef,
+                    otherEndpoint: targetRef,
+                });
+                pushView(targetKey, {
+                    ...baseView,
+                    kind: "blocked_by",
+                    selfEndpoint: targetRef,
+                    otherEndpoint: sourceRef,
+                });
+                break;
+            case "related_to":
+                pushView(sourceKey, {
+                    ...baseView,
+                    kind: "related_to",
+                    selfEndpoint: sourceRef,
+                    otherEndpoint: targetRef,
+                });
+                pushView(targetKey, {
+                    ...baseView,
+                    kind: "related_to",
+                    selfEndpoint: targetRef,
+                    otherEndpoint: sourceRef,
+                });
+                break;
+            case "duplicate_of":
+                pushView(sourceKey, {
+                    ...baseView,
+                    kind: "duplicate_of",
+                    selfEndpoint: sourceRef,
+                    otherEndpoint: targetRef,
+                });
+                break;
+            case "follows":
+                pushView(sourceKey, {
+                    ...baseView,
+                    kind: "follows",
+                    selfEndpoint: sourceRef,
+                    otherEndpoint: targetRef,
+                });
+                break;
+        }
+    }
+    const cycleDiagnostics = detectBlocksCycles(resolvedRows.filter((r) => r.link.kind === "blocks"));
+    diagnostics.push(...cycleDiagnostics);
+    return { linksByEndpoint, diagnostics };
+}
+function detectBlocksCycles(rows) {
+    const sortedRows = [...rows].sort((a, b) => a.link.id.localeCompare(b.link.id));
+    const adj = new Map();
+    const refByKey = new Map();
+    const allKeys = new Set();
+    for (const row of sortedRows) {
+        const fromKey = endpointKey(row.sourceRef);
+        const toKey = endpointKey(row.targetRef);
+        refByKey.set(fromKey, row.sourceRef);
+        refByKey.set(toKey, row.targetRef);
+        allKeys.add(fromKey);
+        allKeys.add(toKey);
+        const edges = adj.get(fromKey) ?? [];
+        edges.push({ to: toKey, toRef: row.targetRef, linkId: row.link.id });
+        adj.set(fromKey, edges);
+    }
+    for (const edges of adj.values()) {
+        edges.sort((a, b) => a.to.localeCompare(b.to));
+    }
+    const nodes = Array.from(allKeys).sort();
+    const color = new Map();
+    for (const n of nodes)
+        color.set(n, "white");
+    const pathKeys = [];
+    const pathLinkIds = [];
+    const cycles = [];
+    const seen = new Set();
+    function dfs(node) {
+        color.set(node, "gray");
+        pathKeys.push(node);
+        const edges = adj.get(node) ?? [];
+        for (const { to, linkId } of edges) {
+            const c = color.get(to);
+            if (c === "gray") {
+                const idx = pathKeys.indexOf(to);
+                const cycleNodes = pathKeys.slice(idx);
+                const cycleLinkIds = pathLinkIds.slice(idx).concat(linkId);
+                const dedupKey = [...cycleNodes].sort().join("|");
+                if (!seen.has(dedupKey)) {
+                    seen.add(dedupKey);
+                    const cycleEndpoints = cycleNodes
+                        .map((k) => refByKey.get(k))
+                        .filter((r) => r !== undefined);
+                    cycles.push({
+                        id: `diag-cycle-${cycleLinkIds.join("-")}`,
+                        severity: "error",
+                        category: "policy",
+                        kind: "link_cycle",
+                        objectId: null,
+                        message: `blocks cycle through ${cycleNodes.length} endpoint(s).`,
+                        cycleEndpoints,
+                        cycleLinkIds,
+                    });
+                }
+            }
+            else if (c === "white") {
+                pathLinkIds.push(linkId);
+                dfs(to);
+                pathLinkIds.pop();
+            }
+        }
+        pathKeys.pop();
+        color.set(node, "black");
+    }
+    for (const node of nodes) {
+        if (color.get(node) === "white") {
+            dfs(node);
+        }
+    }
+    return cycles;
+}
+//# sourceMappingURL=workGraphProjection.js.map

package/build/server/products/work/shared/workGraphProjection.js.map

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

package/build/server/products/work/shared/workGraphTypes.d.ts

@@ -0,0 +1,302 @@
+import type { ExternalWorkBindingExternalType, ExternalWorkBindingProvider, ExternalWorkBindingSyncDirection } from "./externalWorkBinding.js";
+/**
+ * Work Graph projection types for the top-down Work surfaces (System Map,
+ * Cockpit, Broken Links). Mirrors the SPEC-083 §Suggested Work Graph Shape.
+ *
+ * The fixture in `./mock.ts` uses these types so the three pages can render
+ * meaningfully before the producer pipeline (chat / code / runtime writes
+ * canonical Core records → server-side projection) is wired up.
+ */
+export type WorkGraphLayer = "interaction" | "planning" | "execution";
+/**
+ * Renderer-only urgency hint persisted under
+ * `task.metadata.workRenderer.priority` (Paperclip-inspired four-step
+ * scale). Defined here rather than next to a single store so the
+ * server-side projection (`/api/work/tasks`) and the renderer hook
+ * agree on the wire shape.
+ */
+export type TaskPriority = "urgent" | "high" | "medium" | "low";
+/**
+ * Per-task product attribution surfaced in the projection so Work-product
+ * surfaces can show the *full* Core task graph while still labelling
+ * which product owns / executes each task. Computed by
+ * `resolveTaskProductBinding`:
+ *
+ *   - 'work'    — task has a Work Item linking to it through
+ *                 `WorkItem.taskId`; this structural bridge is the only
+ *                 way to qualify as `work`. Code / Chat lineage on the
+ *                 same task is preserved on the underlying records
+ *                 across promotion: explicit `planning.productHint` /
+ *                 `planning.transfer.suggestedProduct` if the origin
+ *                 was a planning hint, the linked `code_thread` (or
+ *                 chat-*) `Conversation.kind` if it was a conversation
+ *                 fallback, and any `build` / `preview` `Artifact`
+ *                 attached to the task if it was an artifact-driven
+ *                 binding. None of these is rewritten by promotion;
+ *                 they are NOT exposed via this projection field.
+ *   - 'code'    — task has a build / preview artifact, OR explicit Code
+ *                 planning provenance (`productHint = 'code'` /
+ *                 `transfer.suggestedProduct = 'code'`), OR legacy
+ *                 `code_thread` conversation fallback (no planning).
+ *   - 'chat'    — explicit Chat planning provenance only. Chat-*
+ *                 conversation kind alone does NOT qualify, per the
+ *                 deliberate-only producer rule (Chat Tasks must be
+ *                 explicitly materialized from an active Chat
+ *                 conversation, not auto-bound by conversation kind).
+ *   - 'unbound' — no usable signal; Work-flavoured hint / `work_thread`
+ *                 fallback without the required `WorkItem.taskId`
+ *                 bridge (incomplete Work claim, surfaces as a
+ *                 diagnostic); chat-* conversation without explicit
+ *                 chat provenance.
+ *
+ * Set only on `kind === 'task'` summaries; undefined elsewhere.
+ */
+export type WorkTaskProductBinding = "work" | "code" | "chat" | "unbound";
+export type WorkGraphObjectKind = "agent" | "container" | "conversation" | "turn" | "lane" | "project" | "work_item" | "task" | "mission" | "run" | "artifact" | "activity" | "outcome" | "approval_binding";
+export type WorkAttentionState = "none" | "decision_needed" | "blocked" | "failed" | "ready_to_review" | "recently_shipped";
+export type WorkGraphDiagnosticSeverity = "info" | "warning" | "error";
+export type WorkGraphDiagnosticCategory = "anchor" | "lineage" | "projection" | "policy";
+export type WorkGraphDiagnosticKind = "broken_fk" | "missing_project_anchor" | "missing_planning_execution_bridge" | "unanchored_run" | "unanchored_evidence" | "missing_gate_subject" | "orphan_link" | "link_cycle";
+/**
+ * SPEC-083 base diagnostic kinds — i.e. every diagnostic kind that uses
+ * the plain `WorkGraphDiagnostic` shape. SPEC-090 link diagnostics
+ * (`orphan_link`, `link_cycle`) carry extra payload fields and use
+ * dedicated shapes (`WorkGraphLinkOrphanDiagnostic` /
+ * `WorkGraphLinkCycleDiagnostic`).
+ */
+export type WorkGraphBaseDiagnosticKind = Exclude<WorkGraphDiagnosticKind, "orphan_link" | "link_cycle">;
+/**
+ * SPEC-090 stored link kinds. `blocked_by` is NOT stored — it is a
+ * projection-derived inverse of `blocks` (see SPEC-090 §FR5).
+ */
+export type WorkGraphLinkKind = "blocks" | "related_to" | "duplicate_of" | "follows";
+/**
+ * Read-side view kinds the projection synthesizes per object. Includes
+ * the derived `blocked_by` view that does not appear in storage.
+ */
+export type WorkGraphLinkViewKind = WorkGraphLinkKind | "blocked_by";
+/**
+ * SPEC-090 v1 limits link endpoints to Project / Work Item / Task. The
+ * matching `sourceRecordFamily` field on `WorkGraphObjectSummary` is
+ * typed wider (`WorkGraphObjectKind`) because a summary can also cover
+ * non-PWT objects like Conversation / Run / Artifact.
+ */
+export type WorkGraphLinkEndpointKind = "project" | "work_item" | "task";
+export interface WorkGraphLinkEndpointRef {
+    recordFamily: WorkGraphLinkEndpointKind;
+    recordId: string;
+}
+/**
+ * Serializable composite key form: `${recordFamily}:${recordId}`.
+ * Stable across projection rebuilds because Core identity drives it.
+ */
+export type WorkGraphEndpointKey = `${WorkGraphLinkEndpointKind}:${string}`;
+/** SPEC-090 stored link row. Endpoints reference canonical Core identity. */
+export interface WorkGraphLink {
+    id: string;
+    kind: WorkGraphLinkKind;
+    sourceRecordFamily: WorkGraphLinkEndpointKind;
+    sourceRecordId: string;
+    targetRecordFamily: WorkGraphLinkEndpointKind;
+    targetRecordId: string;
+    createdAt: string;
+    createdByActorId: string | null;
+    note: string | null;
+}
+/**
+ * Per-endpoint read-side projection of a link, oriented "from this
+ * endpoint's perspective". `kind` may be `blocked_by` even though no
+ * stored row has that kind — see SPEC-090 §FR5.
+ */
+export interface WorkGraphLinkView {
+    linkId: string;
+    kind: WorkGraphLinkViewKind;
+    selfEndpoint: WorkGraphLinkEndpointRef;
+    otherEndpoint: WorkGraphLinkEndpointRef;
+    note: string | null;
+    createdAt: string;
+}
+/**
+ * Project / Work Item read-side summary of locally linked external tracker
+ * records. The canonical binding remains in Core metadata; this projection
+ * exposes the stable fields UI surfaces and model observations need without
+ * making external trackers the system of record.
+ */
+export interface WorkGraphExternalBindingSummary {
+    provider: ExternalWorkBindingProvider;
+    externalType: ExternalWorkBindingExternalType;
+    externalId: string;
+    externalUrl: string | null;
+    syncDirection: ExternalWorkBindingSyncDirection;
+    lastSyncedAt: string | null;
+    externalUpdatedAt: string | null;
+    linkedAt: string;
+    linkedByActorRef: string | null;
+}
+export interface WorkGraphObjectSummary {
+    id: string;
+    kind: WorkGraphObjectKind;
+    /** null for cross-cutting evidence and gate objects. */
+    structuralLayer: WorkGraphLayer | null;
+    /**
+     * Canonical Core record family this summary projects from. SPEC-083 §
+     * Suggested Work Graph Shape publishes this as `string` so non-PWT
+     * objects can carry their own family (`conversation`, `run`, `artifact`,
+     * etc.); SPEC-090 narrows the value space on link endpoints to
+     * `project | work_item | task` only — the link record's
+     * `sourceRecordFamily` / `targetRecordFamily` fields use the narrower
+     * `WorkGraphLinkEndpointKind` enum.
+     */
+    sourceRecordFamily: WorkGraphObjectKind;
+    /** Canonical Core record id within `sourceRecordFamily`. */
+    sourceRecordId: string;
+    title: string;
+    status: string;
+    summary: string | null;
+    attention: WorkAttentionState;
+    ownerRole: string | null;
+    nextAction: string | null;
+    linkedConversationId: string | null;
+    linkedProjectId: string | null;
+    linkedWorkItemId: string | null;
+    linkedTaskId: string | null;
+    linkedRunId: string | null;
+    updatedAt: string;
+    /**
+     * Pass-through of the Core record's metadata bag. Renderer-only
+     * extras (e.g. tasks' `workRenderer.priority` / `assigneeName` /
+     * `acceptanceCriteria`) ride through here so they survive a refresh.
+     * Optional: omitted for record families without a metadata field.
+     */
+    metadata?: Record<string, unknown> | null;
+    /**
+     * Task-only: which product owns / executes this task. See
+     * `WorkTaskProductBinding`. Set on `kind === 'task'` summaries;
+     * undefined for projects, work items, runs, agents, etc. Lets
+     * UI surfaces (System Map, Tasks list, Cockpit) display the
+     * full Core task graph and still label each task by product
+     * — a graph-projection-level alternative to filtering tasks
+     * out at the API boundary.
+     */
+    productBinding?: WorkTaskProductBinding;
+    /**
+     * Project / Work Item only: locally linked external tracker records
+     * (GitHub Issues, Gitea, Redmine, Bugzilla, etc.). Undefined when the
+     * object has no valid external binding metadata.
+     */
+    externalBindings?: WorkGraphExternalBindingSummary[];
+    /**
+     * Run-only: lifecycle timestamps. Set on `kind === 'run'` summaries;
+     * undefined elsewhere. `startedAt` is null while queued, set when
+     * the run picks up. `completedAt` is null while running / blocked,
+     * set when the run reaches a terminal status (completed / failed /
+     * cancelled). Lets Run drill-downs render duration without a
+     * second fetch.
+     */
+    startedAt?: string | null;
+    completedAt?: string | null;
+    /**
+     * Denormalized title of `linkedTaskId` (when present and resolvable
+     * in the same projection). Set on `kind === 'task'` (parent of a
+     * sub-task) and `kind === 'run'` (the task that owns this run);
+     * undefined for other kinds. Lets Cockpit / System Map / list cards
+     * render a "belongs to" chip without each consumer building its own
+     * task lookup map.
+     */
+    linkedTaskTitle?: string | null;
+    /**
+     * Denormalized title of `linkedWorkItemId` (when present and
+     * resolvable). Set on `kind === 'work_item'` (parent of a
+     * sub-work-item — `linkedWorkItemId` aliases `parentWorkItemId` on
+     * work-item summaries); undefined for other kinds. Symmetric to
+     * `linkedTaskTitle`.
+     */
+    linkedWorkItemTitle?: string | null;
+    /**
+     * Denormalized title of `linkedConversationId` (when present and
+     * resolvable in the projection). Populated for any kind whose Core
+     * record has a `conversationId` foreign key (project / work_item /
+     * task / mission / run / artifact / activity / outcome /
+     * approval_binding). Lets detail pages show "Conversation: <title>"
+     * without each consumer building its own conversation lookup.
+     */
+    linkedConversationTitle?: string | null;
+    /**
+     * Resolved actor titles (display names) for the Core record's
+     * canonical assignment list. Set on `kind === 'task'` from
+     * `task.assignedActorIds`; on `kind === 'mission'` from the single
+     * `mission.assignedAgentId` (one-element array). Undefined for
+     * other kinds. Each entry is a name resolved against `core.actors`,
+     * falling back to the actor id when not resolvable. Empty array
+     * means the record has the field but no actors are assigned.
+     */
+    assignedActorTitles?: string[];
+    /**
+     * Denormalized title of `linkedRunId` (when present and resolvable).
+     * Set on `kind === 'run'` (parent run via parentRunId); undefined
+     * for other kinds. Symmetric to `linkedTaskTitle` /
+     * `linkedWorkItemTitle`.
+     */
+    linkedRunTitle?: string | null;
+}
+export interface WorkGraphEvidenceAttachment {
+    evidenceObjectId: string;
+    anchorObjectId: string;
+    relation: "artifact" | "activity" | "outcome";
+}
+export interface WorkGraphGateDecorator {
+    gateObjectId: string;
+    subjectObjectId: string;
+    state: "not_requested" | "pending" | "approved" | "rejected";
+}
+export interface WorkGraphDiagnostic {
+    id: string;
+    severity: WorkGraphDiagnosticSeverity;
+    category: WorkGraphDiagnosticCategory;
+    kind: WorkGraphBaseDiagnosticKind;
+    objectId: string | null;
+    message: string;
+}
+export interface WorkGraphLinkOrphanDiagnostic {
+    id: string;
+    severity: WorkGraphDiagnosticSeverity;
+    category: WorkGraphDiagnosticCategory;
+    kind: "orphan_link";
+    objectId: string | null;
+    message: string;
+    linkId: string;
+    sourceEndpoint: WorkGraphLinkEndpointRef;
+    targetEndpoint: WorkGraphLinkEndpointRef;
+    unresolvedSide: "source" | "target" | "both";
+}
+export interface WorkGraphLinkCycleDiagnostic {
+    id: string;
+    severity: WorkGraphDiagnosticSeverity;
+    category: WorkGraphDiagnosticCategory;
+    kind: "link_cycle";
+    objectId: string | null;
+    message: string;
+    cycleEndpoints: WorkGraphLinkEndpointRef[];
+    /**
+     * Stored `blocks` rows that participate in the cycle, in cycle
+     * traversal order. Lets Broken Links offer a one-click
+     * "remove this link" affordance per row.
+     */
+    cycleLinkIds: string[];
+}
+export type WorkGraphLinkDiagnostic = WorkGraphLinkOrphanDiagnostic | WorkGraphLinkCycleDiagnostic;
+export interface WorkGraphProjection {
+    objects: WorkGraphObjectSummary[];
+    evidenceAttachments: WorkGraphEvidenceAttachment[];
+    gateDecorators: WorkGraphGateDecorator[];
+    /** Raw stored link rows, including orphans (so Broken Links can iterate them). */
+    links: WorkGraphLink[];
+    /**
+     * Per-endpoint derived link views (sparse map). Orphan rows are
+     * EXCLUDED — they appear only as `orphan_link` diagnostics. Consumers
+     * MUST treat absence of a key as `[]`.
+     */
+    linksByEndpoint: Partial<Record<WorkGraphEndpointKey, WorkGraphLinkView[]>>;
+    diagnostics: Array<WorkGraphDiagnostic | WorkGraphLinkDiagnostic>;
+}
+//# sourceMappingURL=workGraphTypes.d.ts.map

package/build/server/products/work/shared/workGraphTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workGraphTypes.d.ts","sourceRoot":"","sources":["../../../../../src/products/work/shared/workGraphTypes.ts"],"names":[],"mappings":"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"}

package/build/server/products/work/shared/workGraphTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workGraphTypes.js.map

package/build/server/products/work/shared/workGraphTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workGraphTypes.js","sourceRoot":"","sources":["../../../../../src/products/work/shared/workGraphTypes.ts"],"names":[],"mappings":""}

package/build/server/products/work/shared/workIntakeSourceContext.d.ts

@@ -0,0 +1,23 @@
+import type { WorkItemSourceRef, WorkToolSourceSurface } from './workToolSurface.js';
+export interface BuildWorkIntakeSourceContextInput {
+    surface: WorkToolSourceSurface;
+    conversationId?: string | null;
+    channelId?: string | null;
+    transportBindingId?: string | null;
+    sourceMessageId?: string | null;
+    sourceText?: string | null;
+}
+export interface WorkIntakeSourceContext {
+    sourceRef: WorkItemSourceRef;
+    contextRefs: string[];
+    metadata: {
+        phase: 'intake';
+        surface: WorkToolSourceSurface;
+        conversationId: string | null;
+        channelId: string | null;
+        transportBindingId: string | null;
+        sourceMessageId: string | null;
+    };
+}
+export declare function buildWorkIntakeSourceContext(input: BuildWorkIntakeSourceContextInput): WorkIntakeSourceContext;
+//# sourceMappingURL=workIntakeSourceContext.d.ts.map

package/build/server/products/work/shared/workIntakeSourceContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workIntakeSourceContext.d.ts","sourceRoot":"","sources":["../../../../../src/products/work/shared/workIntakeSourceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,qBAAqB,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE;QACR,KAAK,EAAE,QAAQ,CAAC;QAChB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,uBAAuB,CAsBzB"}

package/build/server/products/work/shared/workIntakeSourceContext.js

@@ -0,0 +1,41 @@
+export function buildWorkIntakeSourceContext(input) {
+    const sourceRef = {
+        surface: input.surface,
+        conversationId: normalizeOptionalString(input.conversationId),
+        channelId: normalizeOptionalString(input.channelId),
+        transportBindingId: normalizeOptionalString(input.transportBindingId),
+        sourceMessageId: normalizeOptionalString(input.sourceMessageId),
+        sourceText: normalizeOptionalString(input.sourceText),
+    };
+    return {
+        sourceRef,
+        contextRefs: buildContextRefs(sourceRef),
+        metadata: {
+            phase: 'intake',
+            surface: sourceRef.surface,
+            conversationId: sourceRef.conversationId ?? null,
+            channelId: sourceRef.channelId ?? null,
+            transportBindingId: sourceRef.transportBindingId ?? null,
+            sourceMessageId: sourceRef.sourceMessageId ?? null,
+        },
+    };
+}
+function buildContextRefs(sourceRef) {
+    return [
+        `work-intake-surface:${sourceRef.surface}`,
+        sourceRef.conversationId ? `work-intake-conversation:${sourceRef.conversationId}` : null,
+        sourceRef.channelId ? `work-intake-channel:${sourceRef.channelId}` : null,
+        sourceRef.transportBindingId
+            ? `work-intake-transport-binding:${sourceRef.transportBindingId}`
+            : null,
+        sourceRef.sourceMessageId ? `work-intake-source-message:${sourceRef.sourceMessageId}` : null,
+    ].filter((value) => value !== null);
+}
+function normalizeOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=workIntakeSourceContext.js.map

package/build/server/products/work/shared/workIntakeSourceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workIntakeSourceContext.js","sourceRoot":"","sources":["../../../../../src/products/work/shared/workIntakeSourceContext.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,4BAA4B,CAC1C,KAAwC;IAExC,MAAM,SAAS,GAAsB;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,cAAc,EAAE,uBAAuB,CAAC,KAAK,CAAC,cAAc,CAAC;QAC7D,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC;QACnD,kBAAkB,EAAE,uBAAuB,CAAC,KAAK,CAAC,kBAAkB,CAAC;QACrE,eAAe,EAAE,uBAAuB,CAAC,KAAK,CAAC,eAAe,CAAC;QAC/D,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,UAAU,CAAC;KACtD,CAAC;IAEF,OAAO;QACL,SAAS;QACT,WAAW,EAAE,gBAAgB,CAAC,SAAS,CAAC;QACxC,QAAQ,EAAE;YACR,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,IAAI;YAChD,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,IAAI;YACtC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,IAAI,IAAI;YACxD,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI;SACnD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,SAA4B;IACpD,OAAO;QACL,uBAAuB,SAAS,CAAC,OAAO,EAAE;QAC1C,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,4BAA4B,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI;QACxF,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;QACzE,SAAS,CAAC,kBAAkB;YAC1B,CAAC,CAAC,iCAAiC,SAAS,CAAC,kBAAkB,EAAE;YACjE,CAAC,CAAC,IAAI;QACR,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,8BAA8B,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI;KAC7F,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAgC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/build/server/products/work/shared/workToolIntent.d.ts

@@ -0,0 +1,21 @@
+import type { ToolIntentManifest } from '../../../platform/orchestration/contracts.js';
+import type { SupervisionToolScope } from '../../../platform/supervision/contracts.js';
+import { WORK_MCP_PROFILE_ID } from '../../../shared/catMcpProfiles.js';
+import { type WorkToolCapabilityProfile, type WorkToolPhase } from './workToolSurface.js';
+export { WORK_MCP_PROFILE_ID };
+type ToolIntentContext = NonNullable<ToolIntentManifest['context']>;
+export interface PhaseScopedWorkToolIntentInput {
+    profileId?: string | null;
+    phase: WorkToolPhase;
+    capabilityProfile: WorkToolCapabilityProfile;
+    policyToolScope: SupervisionToolScope;
+    parentToolScope?: SupervisionToolScope;
+    channelId?: string | null;
+    catId?: string | null;
+    participantKind?: ToolIntentContext['participantKind'];
+    roomMode?: ToolIntentContext['roomMode'];
+    transport?: ToolIntentContext['transport'];
+    strict?: boolean;
+}
+export declare function resolvePhaseScopedWorkToolIntentManifest(input: PhaseScopedWorkToolIntentInput): ToolIntentManifest | null;
+//# sourceMappingURL=workToolIntent.d.ts.map

package/build/server/products/work/shared/workToolIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workToolIntent.d.ts","sourceRoot":"","sources":["../../../../../src/products/work/shared/workToolIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,KAAK,iBAAiB,GAAG,WAAW,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,eAAe,EAAE,oBAAoB,CAAC;IACtC,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,8BAA8B,GACpC,kBAAkB,GAAG,IAAI,CA0C3B"}