[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_228":-5,"_231":232,"_233":234},"routes/shell",{"_40":41,"_227":-5,"_228":-5,"_229":230},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","8ee2f8dddd22018f52ccaf200ab6e79bbdaad777","path","apps/server/src/chat/references.ts","oid","a692d119365c1027ad3192303e4159912b5938e3","size",25343,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","import { createHash } from \"node:crypto\";\n\nimport { ULID, ulid } from \"@chopin/dialect\";\nimport { documentPath, parseDocumentPath } from \"@chopin/protocol/document-url\";\nimport { instruction, MENTION } from \"@chopin/protocol/address\";\n\nimport { isChannelId } from \"../channels/id\";\nimport {\n\tparseResearchAnswerArtifact,\n\tparseResearchEvidenceArtifact,\n} from \"../jobs/research-workspace\";\n\nimport type { Chat as Wire, Job } from \"@chopin/protocol\";\nimport type { JsonValue } from \"../storage/model\";\nimport type { StorageAdapter } from \"../storage/port\";\nimport type { DocumentTarget } from \"../plan/service\";\nimport type { ResearchWorkspaceService, ResearchWorkspaceView } from \"../research/service\";\n\nconst MAX_REFERENCES = 10;\nconst MAX_TOKEN = 256;\nconst MAX_LABEL = 121;\nconst MAX_HREF = 2_048;\nconst MAX_REPOSITORY_ID = 255;\nconst MAX_WORKSPACE_ID = 96;\nconst MAX_RESEARCH_TURNS = 12;\nconst MAX_RESEARCH_TURN_BYTES = 2 * 1024 * 1024;\nconst MAX_RESEARCH_MESSAGES = 100;\nconst MAX_RESEARCH_MESSAGE = 4_096;\nconst MAX_RESEARCH_MESSAGE_BYTES = 256 * 1024;\nconst SOURCE_HASH = /^sha256:[0-9a-f]{64}$/;\nconst SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;\nconst LEGACY_RESEARCH_PATH =\n\t/^\\/documents\\/([^/?#]+)\\/([^/?#]+)\\/([^/?#]+)\\/research\\/([^/?#]+)\\/?$/;\n\n// Persisted chat references retain the removed product route as an opaque canonical identity.\nfunction legacyResearchPath(\n\towner: string,\n\trepository: string,\n\tslug: string,\n\tworkspaceId: string,\n): string {\n\treturn `/documents/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/${\n\t\tencodeURIComponent(slug)\n\t}/research/${encodeURIComponent(workspaceId)}`;\n}\n\nfunction parseLegacyResearchPath(value: string): {\n\towner: string;\n\trepository: string;\n\tslug: string;\n\tworkspaceId: string;\n} | undefined {\n\tlet match = LEGACY_RESEARCH_PATH.exec(value);\n\tif (!match) return undefined;\n\ttry {\n\t\tlet owner = decodeURIComponent(match[1]!);\n\t\tlet repository = decodeURIComponent(match[2]!);\n\t\tlet slug = decodeURIComponent(match[3]!);\n\t\tlet workspaceId = decodeURIComponent(match[4]!);\n\t\treturn owner && repository && slug && workspaceId\n\t\t\t? { owner, repository, slug, workspaceId }\n\t\t\t: undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport class ChatReferenceError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"ChatReferenceError\";\n\t}\n}\n\nexport type ReferenceServiceOptions = {\n\tstorage: StorageAdapter;\n\tcurrent: (channelId: string) => Promise;\n\tresearch: ResearchWorkspaceService;\n\tid?: () => string;\n};\n\nexport type ResolveReferences = {\n\tchannelId: string;\n\trepositoryId: string;\n\ttext: string;\n\tdestination: Wire.Destination;\n\trequests?: Wire.ReferenceRequest[];\n};\n\nexport type ResolvedMessage = {\n\ttext: string;\n\treferences?: Wire.Reference[];\n};\n\nexport type ReadReference = {\n\tchannelId: string;\n\trepositoryId: string;\n\treference: Wire.Reference;\n};\n\ntype TextUnit = { value: string; reference?: number };\n\nfunction hasControlCharacter(value: string): boolean {\n\tfor (let index = 0; index < value.length; index++) {\n\t\tlet code = value.charCodeAt(index);\n\t\tif (code <= 31 || code === 127) return true;\n\t}\n\treturn false;\n}\n\nfunction opaqueId(value: unknown, maximum: number): value is string {\n\treturn typeof value === \"string\" && value.length >= 1 && value.length <= maximum\n\t\t&& !hasControlCharacter(value);\n}\n\nfunction safeWorkspaceId(value: unknown): value is string {\n\treturn typeof value === \"string\" && value.length >= 1 && value.length <= MAX_WORKSPACE_ID\n\t\t&& SAFE_ID.test(value);\n}\n\nfunction safeBoundary(text: string, boundary: number): boolean {\n\tif (boundary <= 0 || boundary >= text.length) return true;\n\tlet previous = text.charCodeAt(boundary - 1);\n\tlet next = text.charCodeAt(boundary);\n\treturn !(previous >= 0xd800 && previous <= 0xdbff && next >= 0xdc00 && next <= 0xdfff);\n}\n\nfunction token(text: string, start: number, end: number, marker: \"#\" | \"%\"): string {\n\tif (\n\t\t!Number.isSafeInteger(start) || !Number.isSafeInteger(end)\n\t\t|| start < 0 || end <= start || end > text.length || end - start > MAX_TOKEN\n\t\t|| !safeBoundary(text, start) || !safeBoundary(text, end)\n\t) throw new ChatReferenceError(\"Reference range is invalid.\");\n\tlet value = text.slice(start, end);\n\tif (!value.startsWith(marker) || [...value].length > MAX_LABEL || hasControlCharacter(value)) {\n\t\tthrow new ChatReferenceError(\"Reference token is invalid.\");\n\t}\n\treturn value;\n}\n\nfunction exact(value: Record, fields: string[]): boolean {\n\tlet keys = Object.keys(value).sort();\n\tlet expected = [...fields].sort();\n\treturn keys.length === expected.length && keys.every((key, index) => key === expected[index]);\n}\n\nfunction request(value: unknown): Wire.ReferenceRequest {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new ChatReferenceError(\"Reference request is invalid.\");\n\t}\n\tlet item = value as Record;\n\tif (item.kind === \"document\") {\n\t\tif (\n\t\t\t!exact(item, [\"channelId\", \"end\", \"kind\", \"start\"])\n\t\t\t|| typeof item.channelId !== \"string\" || !isChannelId(item.channelId)\n\t\t) {\n\t\t\tthrow new ChatReferenceError(\"Document reference is invalid.\");\n\t\t}\n\t\treturn item as Wire.ReferenceRequest;\n\t}\n\tif (item.kind === \"research\") {\n\t\tif (\n\t\t\t!exact(item, [\"end\", \"kind\", \"start\", \"workspaceId\"])\n\t\t\t|| !safeWorkspaceId(item.workspaceId)\n\t\t) throw new ChatReferenceError(\"Research reference is invalid.\");\n\t\treturn item as Wire.ReferenceRequest;\n\t}\n\tthrow new ChatReferenceError(\"Reference kind is invalid.\");\n}\n\nfunction isWord(value: string | undefined): boolean {\n\treturn value !== undefined && /[A-Za-z0-9_]/.test(value);\n}\n\nfunction requests(text: string, value: unknown): Wire.ReferenceRequest[] {\n\tif (value !== undefined && !Array.isArray(value)) {\n\t\tthrow new ChatReferenceError(\"References must be an array.\");\n\t}\n\tlet values = value as unknown[] | undefined;\n\tif ((values?.length ?? 0) > MAX_REFERENCES) {\n\t\tthrow new ChatReferenceError(`A message may contain at most ${MAX_REFERENCES} references.`);\n\t}\n\tlet parsed = Array.from(values ?? [], request);\n\tlet previousEnd = -1;\n\tlet targets = new Set();\n\tfor (let item of parsed) {\n\t\tif (item.start < previousEnd) {\n\t\t\tthrow new ChatReferenceError(\"References must be sorted and disjoint.\");\n\t\t}\n\t\tlet marker: \"#\" | \"%\" = item.kind === \"document\" ? \"#\" : \"%\";\n\t\ttoken(text, item.start, item.end, marker);\n\t\tpreviousEnd = item.end;\n\t\tlet target = `${item.kind}:${item.kind === \"document\" ? item.channelId : item.workspaceId}`;\n\t\tif (targets.has(target)) throw new ChatReferenceError(\"Reference targets must be unique.\");\n\t\ttargets.add(target);\n\t}\n\treturn parsed;\n}\n\nfunction units(value: string, referenceIndex?: number): TextUnit[] {\n\tlet result: TextUnit[] = [];\n\tfor (let index = 0; index < value.length; index++) {\n\t\tresult.push({\n\t\t\tvalue: value[index]!,\n\t\t\t...(referenceIndex !== undefined ? { reference: referenceIndex } : {}),\n\t\t});\n\t}\n\treturn result;\n}\n\n/** Remove Planner addressing only from prose; canonical reference labels are opaque. */\nfunction plannerText(input: TextUnit[]): TextUnit[] {\n\tlet text = input.map(unit => unit.value).join(\"\");\n\tlet filtered: TextUnit[] = [];\n\tfor (let source = 0; source < input.length; source++) {\n\t\tif (\n\t\t\ttext.slice(source, source + MENTION.length).toLowerCase() === MENTION\n\t\t\t&& (source === 0 || !isWord(text[source - 1]) && text[source - 1] !== \"@\")\n\t\t\t&& !isWord(text[source + MENTION.length])\n\t\t\t&& input.slice(source, source + MENTION.length).every(unit => unit.reference === undefined)\n\t\t) {\n\t\t\tsource += MENTION.length - 1;\n\t\t\tcontinue;\n\t\t}\n\t\tfiltered.push(input[source]!);\n\t}\n\n\tlet collapsed: TextUnit[] = [];\n\tfor (let index = 0; index < filtered.length;) {\n\t\tlet current = filtered[index]!;\n\t\tif (current.reference !== undefined || !/[^\\S\\n]/.test(current.value)) {\n\t\t\tcollapsed.push(current);\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tlet end = index + 1;\n\t\twhile (\n\t\t\tend < filtered.length && filtered[end]!.reference === undefined\n\t\t\t&& /[^\\S\\n]/.test(filtered[end]!.value)\n\t\t) end++;\n\t\tcollapsed.push(end - index >= 2 ? { value: \" \" } : current);\n\t\tindex = end;\n\t}\n\n\tlet start = 0;\n\tlet end = collapsed.length;\n\twhile (\n\t\tstart < end && collapsed[start]!.reference === undefined\n\t\t&& /\\s/.test(collapsed[start]!.value)\n\t) start++;\n\twhile (\n\t\tend > start && collapsed[end - 1]!.reference === undefined\n\t\t&& /\\s/.test(collapsed[end - 1]!.value)\n\t) end--;\n\treturn collapsed.slice(start, end);\n}\n\nfunction canonicalMessage(\n\ttext: string,\n\tdestination: Wire.Destination,\n\treferences: Wire.Reference[],\n): ResolvedMessage {\n\tif (references.length === 0) {\n\t\treturn { text: destination === \"planner\" ? instruction(text) : text.trim() };\n\t}\n\tlet canonical: TextUnit[] = [];\n\tlet cursor = 0;\n\tfor (let [index, reference] of references.entries()) {\n\t\tcanonical.push(...units(text.slice(cursor, reference.start)));\n\t\tcanonical.push(...units(reference.label, index));\n\t\tcursor = reference.end;\n\t}\n\tcanonical.push(...units(text.slice(cursor)));\n\tif (destination === \"planner\") canonical = plannerText(canonical);\n\telse {\n\t\tlet start = 0;\n\t\tlet end = canonical.length;\n\t\twhile (\n\t\t\tstart < end && canonical[start]!.reference === undefined && /\\s/.test(canonical[start]!.value)\n\t\t) {\n\t\t\tstart++;\n\t\t}\n\t\twhile (\n\t\t\tend > start && canonical[end - 1]!.reference === undefined\n\t\t\t&& /\\s/.test(canonical[end - 1]!.value)\n\t\t) end--;\n\t\tcanonical = canonical.slice(start, end);\n\t}\n\n\tlet visible = canonical.map(unit => unit.value).join(\"\");\n\tlet ranges = references.map(() => ({ start: -1, end: -1 }));\n\tfor (let [index, unit] of canonical.entries()) {\n\t\tif (unit.reference === undefined) continue;\n\t\tlet range = ranges[unit.reference]!;\n\t\tif (range.start < 0) range.start = index;\n\t\trange.end = index + 1;\n\t}\n\tlet restored = references.map((reference, index) => {\n\t\tlet range = ranges[index]!;\n\t\tif (\n\t\t\trange.start < 0 || range.end <= range.start\n\t\t\t|| visible.slice(range.start, range.end) !== reference.label\n\t\t) throw new ChatReferenceError(\"Canonical reference range is invalid.\");\n\t\treturn { ...reference, ...range };\n\t});\n\treturn { text: visible, references: restored };\n}\n\nfunction hash(source: string): string {\n\treturn `sha256:${createHash(\"sha256\").update(source).digest(\"hex\")}`;\n}\n\nfunction currentDocument(value: DocumentTarget | undefined, channelId: string): DocumentTarget {\n\tlet target = value ?? { channelId, revision: 0, source: \"\", sourceHash: hash(\"\") };\n\tif (\n\t\ttarget.channelId !== channelId || !Number.isSafeInteger(target.revision) || target.revision < 0\n\t\t|| typeof target.source !== \"string\" || !SOURCE_HASH.test(target.sourceHash)\n\t\t|| hash(target.source) !== target.sourceHash\n\t) throw new ChatReferenceError(\"Referenced document state is invalid.\");\n\treturn target;\n}\n\nfunction validLabel(value: unknown, marker: \"#\" | \"%\"): value is string {\n\tif (typeof value !== \"string\" || !value.startsWith(marker) || hasControlCharacter(value)) {\n\t\treturn false;\n\t}\n\tlet title = value.slice(1);\n\treturn title.length > 0 && title === title.trim() && [...value].length <= MAX_LABEL;\n}\n\nfunction canonicalDocumentHref(value: unknown): value is string {\n\tif (typeof value !== \"string\" || value.length > MAX_HREF) return false;\n\tlet parsed = parseDocumentPath(value);\n\treturn !!parsed?.slug && documentPath(parsed.owner, parsed.repository, parsed.slug) === value;\n}\n\nfunction canonicalResearchHref(value: unknown): value is string {\n\tif (typeof value !== \"string\" || value.length > MAX_HREF) return false;\n\tlet parsed = parseLegacyResearchPath(value);\n\treturn !!parsed\n\t\t&& legacyResearchPath(parsed.owner, parsed.repository, parsed.slug, parsed.workspaceId)\n\t\t\t=== value;\n}\n\nfunction reference(value: unknown): Wire.Reference {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new ChatReferenceError(\"Stored reference is invalid.\");\n\t}\n\tlet item = value as Record;\n\tlet base = typeof item.id === \"string\" && ULID.test(item.id)\n\t\t&& Number.isSafeInteger(item.start) && Number.isSafeInteger(item.end)\n\t\t&& opaqueId(item.repositoryId, MAX_REPOSITORY_ID)\n\t\t&& typeof item.observedRevision === \"number\"\n\t\t&& Number.isSafeInteger(item.observedRevision) && item.observedRevision >= 0;\n\tif (item.kind === \"document\") {\n\t\tif (\n\t\t\t!base\n\t\t\t|| !exact(item, [\n\t\t\t\t\"channelId\",\n\t\t\t\t\"end\",\n\t\t\t\t\"href\",\n\t\t\t\t\"id\",\n\t\t\t\t\"kind\",\n\t\t\t\t\"label\",\n\t\t\t\t\"observedRevision\",\n\t\t\t\t\"observedSourceHash\",\n\t\t\t\t\"repositoryId\",\n\t\t\t\t\"start\",\n\t\t\t])\n\t\t\t|| typeof item.channelId !== \"string\" || !isChannelId(item.channelId)\n\t\t\t|| !validLabel(item.label, \"#\")\n\t\t\t|| !canonicalDocumentHref(item.href)\n\t\t\t|| typeof item.observedSourceHash !== \"string\"\n\t\t\t|| !SOURCE_HASH.test(item.observedSourceHash)\n\t\t) throw new ChatReferenceError(\"Stored document reference is invalid.\");\n\t\treturn item as Wire.DocumentReference;\n\t}\n\tif (item.kind === \"research\") {\n\t\tlet parsedHref = typeof item.href === \"string\"\n\t\t\t? parseLegacyResearchPath(item.href)\n\t\t\t: undefined;\n\t\tif (\n\t\t\t!base\n\t\t\t|| !exact(item, [\n\t\t\t\t\"end\",\n\t\t\t\t\"href\",\n\t\t\t\t\"id\",\n\t\t\t\t\"kind\",\n\t\t\t\t\"label\",\n\t\t\t\t\"observedRevision\",\n\t\t\t\t\"parentChannelId\",\n\t\t\t\t\"repositoryId\",\n\t\t\t\t\"start\",\n\t\t\t\t\"workspaceId\",\n\t\t\t])\n\t\t\t|| typeof item.parentChannelId !== \"string\" || !isChannelId(item.parentChannelId)\n\t\t\t|| !safeWorkspaceId(item.workspaceId)\n\t\t\t|| !validLabel(item.label, \"%\")\n\t\t\t|| !canonicalResearchHref(item.href)\n\t\t\t|| parsedHref?.workspaceId !== item.workspaceId\n\t\t) throw new ChatReferenceError(\"Stored research reference is invalid.\");\n\t\treturn item as Wire.ResearchReference;\n\t}\n\tthrow new ChatReferenceError(\"Stored reference kind is invalid.\");\n}\n\n/** Strictly restore optional transcript references and verify their ranges against stored text. */\nexport function restoreReferences(\n\tvalue: unknown,\n\ttext: string,\n\tseenIds = new Set(),\n\tscope?: { channelId: string; repositoryId: string },\n): Wire.Reference[] {\n\tif (!Array.isArray(value) || value.length > MAX_REFERENCES) {\n\t\tthrow new ChatReferenceError(\"Stored references are invalid.\");\n\t}\n\tlet restored = value.map(reference);\n\tlet previousEnd = -1;\n\tlet targets = new Set();\n\tfor (let item of restored) {\n\t\tif (item.start < previousEnd) {\n\t\t\tthrow new ChatReferenceError(\"Stored references are not disjoint.\");\n\t\t}\n\t\ttoken(text, item.start, item.end, item.kind === \"document\" ? \"#\" : \"%\");\n\t\tif (text.slice(item.start, item.end) !== item.label) {\n\t\t\tthrow new ChatReferenceError(\"Stored reference label does not match its range.\");\n\t\t}\n\t\tif (\n\t\t\tscope\n\t\t\t&& (item.repositoryId !== scope.repositoryId\n\t\t\t\t|| item.kind === \"document\" && item.channelId === scope.channelId\n\t\t\t\t|| item.kind === \"research\" && item.parentChannelId !== scope.channelId)\n\t\t) throw new ChatReferenceError(\"Stored reference is outside its parent document.\");\n\t\tif (seenIds.has(item.id)) throw new ChatReferenceError(\"Stored reference id is duplicated.\");\n\t\tseenIds.add(item.id);\n\t\tlet target = `${item.kind}:${item.kind === \"document\" ? item.channelId : item.workspaceId}`;\n\t\tif (targets.has(target)) throw new ChatReferenceError(\"Stored reference target is duplicated.\");\n\t\ttargets.add(target);\n\t\tpreviousEnd = item.end;\n\t}\n\treturn restored;\n}\n\nfunction state(value: Job.Detail | undefined): Job.State | undefined {\n\treturn value?.job.state;\n}\n\nfunction evidence(value: Job.Detail | undefined) {\n\tif (value?.job.state !== \"completed\" || !value.artifact) return undefined;\n\tlet artifact = parseResearchEvidenceArtifact(value.artifact.value as JsonValue);\n\treturn {\n\t\tfindings: artifact.findings,\n\t\tsources: artifact.sources,\n\t};\n}\n\nfunction answer(value: Job.Detail | undefined) {\n\tif (value?.job.state !== \"completed\" || !value.artifact) return undefined;\n\tlet artifact = parseResearchAnswerArtifact(value.artifact.value as JsonValue);\n\treturn artifact.kind === \"initial\"\n\t\t? {\n\t\t\tkind: artifact.kind,\n\t\t\tdocumentRevision: artifact.documentRevision,\n\t\t\tdocumentSourceHash: artifact.documentSourceHash,\n\t\t\treport: artifact.report,\n\t\t\tsources: artifact.sources,\n\t\t}\n\t\t: {\n\t\t\tkind: artifact.kind,\n\t\t\tdocumentRevision: artifact.documentRevision,\n\t\t\tdocumentSourceHash: artifact.documentSourceHash,\n\t\t\tanswer: artifact.answer,\n\t\t\tsources: artifact.sources,\n\t\t};\n}\n\nfunction researchTurn(turn: ResearchWorkspaceView[\"turns\"][number]) {\n\tlet evidenceState = state(turn.evidence);\n\tlet answerState = state(turn.answer);\n\tlet evidenceArtifact = evidence(turn.evidence);\n\tlet answerArtifact = answer(turn.answer);\n\treturn {\n\t\tid: turn.id,\n\t\tordinal: turn.ordinal,\n\t\tkind: turn.kind,\n\t\tquestion: turn.question,\n\t\tstates: {\n\t\t\t...(evidenceState ? { evidence: evidenceState } : {}),\n\t\t\t...(answerState ? { answer: answerState } : {}),\n\t\t},\n\t\t...(evidenceArtifact ? { evidence: evidenceArtifact } : {}),\n\t\t...(answerArtifact ? { answer: answerArtifact } : {}),\n\t};\n}\n\nfunction researchTurns(view: ResearchWorkspaceView) {\n\tlet initial = view.turns.find(turn => turn.kind === \"initial\");\n\tlet selected: ReturnType[] = [];\n\tlet bytes = 2;\n\tif (initial) {\n\t\tlet projected = researchTurn(initial);\n\t\tbytes += Buffer.byteLength(JSON.stringify(projected));\n\t\tif (bytes > MAX_RESEARCH_TURN_BYTES) {\n\t\t\tthrow new ChatReferenceError(\"Initial research turn exceeds the reference output limit.\");\n\t\t}\n\t\tselected.push(projected);\n\t}\n\tlet candidates = view.turns.filter(turn => turn !== initial)\n\t\t.toSorted((left, right) => right.ordinal - left.ordinal);\n\tfor (let turn of candidates) {\n\t\tif (selected.length >= MAX_RESEARCH_TURNS) break;\n\t\tlet projected = researchTurn(turn);\n\t\tlet size = Buffer.byteLength(JSON.stringify(projected)) + (selected.length > 0 ? 1 : 0);\n\t\tif (bytes + size > MAX_RESEARCH_TURN_BYTES) break;\n\t\tselected.push(projected);\n\t\tbytes += size;\n\t}\n\tselected.sort((left, right) => left.ordinal - right.ordinal);\n\treturn {\n\t\tturns: selected,\n\t\ttruncation: {\n\t\t\ttotal: view.turns.length,\n\t\t\treturned: selected.length,\n\t\t\ttruncated: selected.length < view.turns.length,\n\t\t\tcountLimit: MAX_RESEARCH_TURNS,\n\t\t\tbyteLimit: MAX_RESEARCH_TURN_BYTES,\n\t\t},\n\t};\n}\n\nfunction boundedMessageText(value: string, maximumBytes: number): string {\n\tlet output = \"\";\n\tlet bytes = 0;\n\tlet points = 0;\n\tfor (let point of value) {\n\t\tlet size = Buffer.byteLength(point);\n\t\tif (points >= MAX_RESEARCH_MESSAGE || bytes + size > maximumBytes) break;\n\t\toutput += point;\n\t\tbytes += size;\n\t\tpoints++;\n\t}\n\treturn output;\n}\n\nfunction researchMessages(view: ResearchWorkspaceView) {\n\tlet eligible = view.messages.filter(message =>\n\t\tmessage.authorKind === \"member\" || message.authorKind === \"agent\"\n\t);\n\tlet candidates = eligible.slice(-MAX_RESEARCH_MESSAGES);\n\tlet messages: Array> = [];\n\tlet remaining = MAX_RESEARCH_MESSAGE_BYTES - 2;\n\tlet truncatedText = false;\n\tfor (let message of candidates.toReversed()) {\n\t\tlet text = boundedMessageText(message.text, Math.max(0, remaining - 512));\n\t\tif (!text) break;\n\t\tlet projected = {\n\t\t\tid: message.id,\n\t\t\tsequence: message.sequence,\n\t\t\t...(message.turnId ? { turnId: message.turnId } : {}),\n\t\t\tauthor: message.authorKind,\n\t\t\t...(message.userHandle ? { handle: message.userHandle } : {}),\n\t\t\ttext,\n\t\t\tcreatedAt: message.createdAt,\n\t\t};\n\t\tlet size = Buffer.byteLength(JSON.stringify(projected)) + (messages.length > 0 ? 1 : 0);\n\t\tif (size > remaining) break;\n\t\tmessages.push(projected);\n\t\tremaining -= size;\n\t\tif (text !== message.text) truncatedText = true;\n\t\tif (remaining <= 0) break;\n\t}\n\tlet values = messages.toReversed();\n\treturn {\n\t\tmessages: values,\n\t\ttruncation: {\n\t\t\ttotal: eligible.length,\n\t\t\treturned: values.length,\n\t\t\ttruncated: truncatedText || values.length < eligible.length,\n\t\t\tcountLimit: MAX_RESEARCH_MESSAGES,\n\t\t\tbyteLimit: MAX_RESEARCH_MESSAGE_BYTES,\n\t\t\ttextLimit: MAX_RESEARCH_MESSAGE,\n\t\t},\n\t};\n}\n\nexport class ReferenceService {\n\t#storage: StorageAdapter;\n\t#current: ReferenceServiceOptions[\"current\"];\n\t#research: ResearchWorkspaceService;\n\t#id: () => string;\n\n\tconstructor(options: ReferenceServiceOptions) {\n\t\tthis.#storage = options.storage;\n\t\tthis.#current = options.current;\n\t\tthis.#research = options.research;\n\t\tthis.#id = options.id ?? ulid;\n\t}\n\n\tasync resolve(input: ResolveReferences): Promise {\n\t\tif (typeof input.text !== \"string\") throw new ChatReferenceError(\"Message text is invalid.\");\n\t\tif (input.destination !== \"room\" && input.destination !== \"planner\") {\n\t\t\tthrow new ChatReferenceError(\"Message destination is invalid.\");\n\t\t}\n\t\tlet requested = requests(input.text, input.requests);\n\t\tif (requested.length === 0) return canonicalMessage(input.text, input.destination, []);\n\t\tlet parent = await this.#storage.channels.get(input.channelId);\n\t\tif (!parent || parent.repositoryId !== input.repositoryId) {\n\t\t\tthrow new ChatReferenceError(\"Current document is unavailable.\");\n\t\t}\n\n\t\tlet resolved = await Promise.all(requested.map(async item => {\n\t\t\tif (item.kind === \"document\") {\n\t\t\t\tif (item.channelId === parent.id) {\n\t\t\t\t\tthrow new ChatReferenceError(\"A document cannot reference itself.\");\n\t\t\t\t}\n\t\t\t\tlet target = await this.#storage.channels.get(item.channelId);\n\t\t\t\tif (!target || target.repositoryId !== parent.repositoryId) {\n\t\t\t\t\tthrow new ChatReferenceError(\"Referenced document is unavailable.\");\n\t\t\t\t}\n\t\t\t\tlet document = currentDocument(await this.#current(target.id), target.id);\n\t\t\t\treturn {\n\t\t\t\t\tkind: \"document\" as const,\n\t\t\t\t\tstart: item.start,\n\t\t\t\t\tend: item.end,\n\t\t\t\t\tlabel: `#${target.title}`,\n\t\t\t\t\thref: documentPath(target.repositoryOwner, target.repositoryName, target.slug),\n\t\t\t\t\trepositoryId: target.repositoryId,\n\t\t\t\t\tobservedRevision: document.revision,\n\t\t\t\t\tchannelId: target.id,\n\t\t\t\t\tobservedSourceHash: document.sourceHash,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet detail = await this.#storage.research.get(parent.id, item.workspaceId);\n\t\t\tif (\n\t\t\t\t!detail || detail.workspace.id !== item.workspaceId\n\t\t\t\t|| detail.workspace.channelId !== parent.id\n\t\t\t) throw new ChatReferenceError(\"Referenced research workspace is unavailable.\");\n\t\t\treturn {\n\t\t\t\tkind: \"research\" as const,\n\t\t\t\tstart: item.start,\n\t\t\t\tend: item.end,\n\t\t\t\tlabel: `%${detail.workspace.title}`,\n\t\t\t\thref: legacyResearchPath(\n\t\t\t\t\tparent.repositoryOwner,\n\t\t\t\t\tparent.repositoryName,\n\t\t\t\t\tparent.slug,\n\t\t\t\t\tdetail.workspace.id,\n\t\t\t\t),\n\t\t\t\trepositoryId: parent.repositoryId,\n\t\t\t\tobservedRevision: detail.workspace.revision,\n\t\t\t\tparentChannelId: parent.id,\n\t\t\t\tworkspaceId: detail.workspace.id,\n\t\t\t};\n\t\t}));\n\n\t\tlet ids = new Set();\n\t\tlet references = resolved.map(item => {\n\t\t\tlet id = this.#id();\n\t\t\tif (!ULID.test(id) || ids.has(id)) throw new ChatReferenceError(\"Reference id is invalid.\");\n\t\t\tids.add(id);\n\t\t\treturn reference({ id, ...item });\n\t\t});\n\t\treturn canonicalMessage(input.text, input.destination, references);\n\t}\n\n\tasync read(input: ReadReference): Promise {\n\t\tlet stored = reference(input.reference);\n\t\tlet parent = await this.#storage.channels.get(input.channelId);\n\t\tif (\n\t\t\t!parent || parent.repositoryId !== input.repositoryId\n\t\t\t|| stored.repositoryId !== parent.repositoryId\n\t\t) throw new ChatReferenceError(\"Reference target is unavailable.\");\n\n\t\tif (stored.kind === \"document\") {\n\t\t\tif (stored.channelId === parent.id) throw new ChatReferenceError(\"Reference target moved.\");\n\t\t\tlet target = await this.#storage.channels.get(stored.channelId);\n\t\t\tif (!target || target.repositoryId !== parent.repositoryId) {\n\t\t\t\tthrow new ChatReferenceError(\"Reference target moved or is unavailable.\");\n\t\t\t}\n\t\t\tlet document = currentDocument(await this.#current(target.id), target.id);\n\t\t\treturn {\n\t\t\t\tuntrusted: true,\n\t\t\t\tkind: stored.kind,\n\t\t\t\tid: stored.id,\n\t\t\t\tlabel: stored.label,\n\t\t\t\ttitle: target.title,\n\t\t\t\tobservedRevision: stored.observedRevision,\n\t\t\t\tobservedSourceHash: stored.observedSourceHash,\n\t\t\t\tcurrentRevision: document.revision,\n\t\t\t\tcurrentSourceHash: document.sourceHash,\n\t\t\t\thref: documentPath(target.repositoryOwner, target.repositoryName, target.slug),\n\t\t\t\tchangedSinceReference: document.revision !== stored.observedRevision\n\t\t\t\t\t|| document.sourceHash !== stored.observedSourceHash,\n\t\t\t\tsource: document.source,\n\t\t\t};\n\t\t}\n\n\t\tif (stored.parentChannelId !== parent.id) {\n\t\t\tthrow new ChatReferenceError(\"Reference target moved.\");\n\t\t}\n\t\tlet view = await this.#research.read(parent.id, stored.workspaceId);\n\t\tif (\n\t\t\t!view || view.workspace.id !== stored.workspaceId\n\t\t\t|| view.workspace.channelId !== stored.parentChannelId\n\t\t) throw new ChatReferenceError(\"Reference target moved or is unavailable.\");\n\t\tlet boundedTurns = researchTurns(view);\n\t\tlet boundedMessages = researchMessages(view);\n\t\treturn {\n\t\t\tuntrusted: true,\n\t\t\tkind: stored.kind,\n\t\t\tid: stored.id,\n\t\t\tlabel: stored.label,\n\t\t\ttitle: view.workspace.title,\n\t\t\tobservedRevision: stored.observedRevision,\n\t\t\tcurrentRevision: view.workspace.revision,\n\t\t\thref: legacyResearchPath(\n\t\t\t\tparent.repositoryOwner,\n\t\t\t\tparent.repositoryName,\n\t\t\t\tparent.slug,\n\t\t\t\tview.workspace.id,\n\t\t\t),\n\t\t\tchangedSinceReference: view.workspace.revision !== stored.observedRevision,\n\t\t\tworkspace: {\n\t\t\t\tid: view.workspace.id,\n\t\t\t\ttitle: view.workspace.title,\n\t\t\t\tproposedQuestion: view.workspace.proposedQuestion,\n\t\t\t\t...(view.workspace.confirmedQuery !== undefined\n\t\t\t\t\t? { confirmedQuery: view.workspace.confirmedQuery }\n\t\t\t\t\t: {}),\n\t\t\t\torigin: view.workspace.origin,\n\t\t\t\trevision: view.workspace.revision,\n\t\t\t\tcreatedAt: view.workspace.createdAt,\n\t\t\t\tupdatedAt: view.workspace.updatedAt,\n\t\t\t},\n\t\t\tturns: boundedTurns.turns,\n\t\t\tmessages: boundedMessages.messages,\n\t\t\ttruncation: {\n\t\t\t\tturns: boundedTurns.truncation,\n\t\t\t\tmessages: boundedMessages.truncation,\n\t\t\t},\n\t\t};\n\t}\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[183,184,185,186,187,188,189,190,191,192,193,194,195],"navigation",{"_54":55,"_139":140,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150},"sources",[],"viewer","meta",{"_131":132,"_133":134,"_135":136,"_42":31,"_137":126,"_138":31,"_48":49,"_50":49},"branches",[73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130],"tags",[69,70,71,72],"cloneUrl","https://git.nexthub.sh/githubnext/chopin.git","color-controls-slice-1","color-controls-slice-2","color-controls-slice-3","color-controls-slice-4","Krzysztof-Cieslak-patch-1","Krzysztof-Cieslak-patch-2","Maggie/app-preview-toolkit","Maggie/ci-playwright-install-timeout","Maggie/collaborative-visual-decision","Maggie/design-audit","Maggie/generic-visual-decision-runtime","Maggie/impeccable-chopin-metadata","Maggie/jev-chat-product","Maggie/jev-composed-assessment","Maggie/native-document-layouts","Maggie/openui-composition-product","Maggie/openui-composition-trial","Maggie/planner-visual-authoring","Maggie/planner-visual-requests","Maggie/visual-selection-eval","artifacts/pr-419-live-preview-20261009","automation/pr-maintenance-state","automation/use-effect/callout-disabled-picker-8cf9e49ba5c09471","automation/use-effect/collaboration-options-ref-4e3a5a08a879a5ae","automation/use-effect/room-workspace-effective-access-a57d40866c71bed0","chore/bun-1.4.2","color-controls","color-controls-plan","comments","design-pr-assets","design/archived-decisions-badge","design/channel-route-remount","design/chat-decision-entry","design/conversation-analysis-markers","design/decision-evidence","design/settled-line-icon","dev/integration","diagram-step-controls","feat/liveapp-frontend-pilot","feat/local-experiments","feat/local-launcher-tracer","fix/autolink-mdx-crash","github-pills/2-pills","github-pills/3-hover-card","maggie/app-preview-toolkit","maggie/ci-playwright-install-timeout","maggie/collaborative-visual-decision","maggie/design-audit","maggie/generic-visual-decision-runtime","maggie/impeccable-chopin-metadata","maggie/jev-composed-assessment","maggie/native-document-layouts","maggie/openui-composition-product","maggie/openui-composition-trial","maggie/planner-visual-authoring","maggie/planner-visual-requests","maggie/visual-selection-eval","main","plain-text-fence-chrome","tokens/09-copy","wireframes/2-renderer","wireframes/3-planner","description","Let's compose rich plans together","owner","githubnext","section","","head","empty","pins",[165,166,167],"documents",{"_160":161,"_162":163},"code",{"_156":157,"_158":159},"automations",{"_153":154,"_155":-5},"delivery",{"_151":49,"_152":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_164":163},"total",11,"issue",{"_168":158,"_170":181,"_15":158,"_172":182,"_52":174,"_175":31,"_176":174,"_177":159},{"_168":178,"_170":179,"_15":178,"_172":180,"_52":174,"_175":31,"_176":174,"_177":49},{"_168":169,"_170":171,"_15":169,"_172":173,"_52":174,"_175":31,"_176":174,"_177":163},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_168":158,"_170":181,"_15":158,"_172":226,"_52":174,"_175":31,"_176":174},{"_168":178,"_170":179,"_15":178,"_172":225,"_52":174,"_175":31,"_176":174},{"_168":169,"_170":171,"_15":169,"_172":224,"_52":174,"_175":31,"_176":174},{"_168":221,"_170":222,"_15":221,"_172":223,"_52":31,"_175":31,"_176":174},{"_168":218,"_170":219,"_15":218,"_172":220,"_52":31,"_175":31,"_176":174},{"_168":153,"_170":216,"_15":145,"_172":217,"_52":31,"_175":31,"_176":174},{"_168":155,"_170":213,"_15":214,"_172":215,"_52":31,"_175":31,"_176":174},{"_168":151,"_170":211,"_15":151,"_172":212,"_52":31,"_175":31,"_176":174},{"_168":207,"_170":208,"_15":209,"_172":210,"_52":31,"_175":31,"_176":174},{"_168":141,"_170":205,"_15":141,"_172":206,"_52":31,"_175":31,"_176":31},{"_168":202,"_170":203,"_15":202,"_172":204,"_52":31,"_175":31,"_176":31},{"_168":199,"_170":200,"_15":199,"_172":201,"_52":31,"_175":31,"_176":31},{"_168":196,"_170":197,"_15":196,"_172":198,"_52":31,"_175":31,"_176":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794471538225,"sidebar","expanded"]