The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
import { ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY } from "@paperclipai/shared";
import { parseDocumentAnnotationHash } from "./document-annotation-hash";
export type IssueDocumentDeepLinkRoute =
| { kind: "continuation-summary" }
| { kind: "properties-pane"; tab: "plans"; documentKey: "plan"; maximize: boolean }
| { kind: "properties-pane"; tab: "document"; documentKey: string; maximize: boolean };
/**
* Maps an issue document hash to the surface that owns that document.
*
* The continuation summary remains in the activity/handoff surface, the plan
* keeps its dedicated pane tab, and every other document opens in its own tab.
* `viewer=full` (LOOA-2181) additionally requests the maximized pane so
* external links (Slack approval cards) land on a full-size reading surface.
*/
export function resolveIssueDocumentDeepLink(hash: string): IssueDocumentDeepLinkRoute | null {
const target = parseDocumentAnnotationHash(hash);
if (!target) return null;
if (target.documentKey === ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY) {
return { kind: "continuation-summary" };
}
const maximize = target.viewer === "full";
if (target.documentKey === "plan") {
return { kind: "properties-pane", tab: "plans", documentKey: "plan", maximize };
}
return { kind: "properties-pane", tab: "document", documentKey: target.documentKey, maximize };
}
/** Resolve document links to this task, including its UUID/identifier aliases. */
export function sameIssueDocumentHash(href: string, currentUrl: URL, issueReferences: string[]): string | null {
let target: URL;
try { target = new URL(href, currentUrl); } catch { return null; }
if (target.origin !== currentUrl.origin || target.search !== currentUrl.search || !resolveIssueDocumentDeepLink(target.hash)) return null;
if (target.pathname === currentUrl.pathname) return target.hash;
const route = /^(?:\/([^/]+))?\/issues\/([^/]+)\/?$/;
const current = currentUrl.pathname.match(route);
const next = target.pathname.match(route);
if (!current || !next || (next[1] && next[1] !== current[1])) return null;
try {
const reference = decodeURIComponent(next[2]!).toLowerCase();
return issueReferences.some((id) => id.toLowerCase() === reference) ? target.hash : null;
} catch { return null; }
}