\n Publish the referenced drafts first before publishing this document.\n

\n)}",{"_29":6688,"_31":6689},[],{"_33":2680,"_35":6690,"_37":1366,"_39":6691,"_63":6692,"_65":6698,"_67":66},"50dFVuS-",{},[6693],{"_33":2751,"_2788":6694,"_2790":6696,"_39":6697,"_67":66},[6695],33,[3088],{},"Disable the publish button while publishBlocked is set, so the user must either edit content (auto-clears) or close.",{"_33":3020,"_35":6700,"_37":1366,"_39":6701,"_63":6702,"_65":6707,"_67":66},"MEdI6TEl",{"_2719":243},[6703],{"_33":2751,"_2788":6704,"_2790":6705,"_39":6706,"_67":66},[912],[6695],{},"4. UI wiring (editing-toolbar.tsx)",{"_29":6709,"_31":6853},[6710,6779,6840],{"_29":6711,"_31":6770},[6712,6723,6734,6741,6748,6759],{"_29":6713,"_31":6714},[],{"_33":2680,"_35":6715,"_37":1366,"_39":6716,"_63":6717,"_65":6722,"_67":66},"zt8f7VEO",{},[6718],{"_33":2751,"_2788":6719,"_2790":6720,"_39":6721,"_67":66},[1182],[2918],{},"empty content → []",{"_29":6724,"_31":6725},[],{"_33":2680,"_35":6726,"_37":1366,"_39":6727,"_63":6728,"_65":6733,"_67":66},"WS1ZIIWe",{},[6729],{"_33":2751,"_2788":6730,"_2790":6731,"_39":6732,"_67":66},[1300],[2806],{},"embed link hm://uid/-abc1234567 → 1 hit",{"_29":6735,"_31":6736},[],{"_33":2680,"_35":6737,"_37":1366,"_39":6738,"_63":6739,"_65":6740,"_67":66},"MnulzLdS",{},[],"nested child block with embed to draft → 1 hit",{"_29":6742,"_31":6743},[],{"_33":2680,"_35":6744,"_37":1366,"_39":6745,"_63":6746,"_65":6747,"_67":66},"zEeG7yaW",{},[],"inline embed annotation to draft → 1 hit",{"_29":6749,"_31":6750},[],{"_33":2680,"_35":6751,"_37":1366,"_39":6752,"_63":6753,"_65":6758,"_67":66},"Eketf60K",{},[6754],{"_33":2751,"_2788":6755,"_2790":6756,"_39":6757,"_67":66},[2965],[2890],{},"query block includes[].space = 'hm://uid/-draftSeg' → 1 hit",{"_29":6760,"_31":6761},[],{"_33":2680,"_35":6762,"_37":1366,"_39":6763,"_63":6764,"_65":6769,"_67":66},"HRBm3Sxz",{},[6765],{"_33":2751,"_2788":6766,"_2790":6767,"_39":6768,"_67":66},[2907,2822],[783,6365],{},"published-only refs (hm://uid/parent/child) → []",{"_33":2680,"_35":6771,"_37":1366,"_39":6772,"_63":6773,"_65":6778,"_67":66},"NkMCyTlO",{"_2719":2972},[6774],{"_33":2751,"_2788":6775,"_2790":6776,"_39":6777,"_67":66},[144,2792],[2551,6572],{},"content-refs.test.ts: extend with findDraftReferences cases:",{"_29":6780,"_31":6830},[6781,6794,6808,6819],{"_29":6782,"_31":6783},[],{"_33":2680,"_35":6784,"_37":1366,"_39":6785,"_63":6786,"_65":6793,"_67":66},"WC3Z3Mv1",{},[6787],{"_33":2751,"_2788":6788,"_2790":6789,"_39":6792,"_67":66},[390,6572,6426],[2918,6790,6791],71,112,{},"send publish.start with draft-link blocks → stays in editing.draft.idle, publishBlocked.reason === 'draft-links'",{"_29":6795,"_31":6796},[],{"_33":2680,"_35":6797,"_37":1366,"_39":6798,"_63":6799,"_65":6807,"_67":66},"gjXZQRgE",{},[6800],{"_33":2751,"_2788":6801,"_2790":6803,"_39":6806,"_67":66},[390,2817,6802],77,[2918,6804,6805],75,100,{},"send publish.start with clean blocks → transitions to publishing.inProgress, publishBlocked === null",{"_29":6809,"_31":6810},[],{"_33":2680,"_35":6811,"_37":1366,"_39":6812,"_63":6813,"_65":6818,"_67":66},"5uw1waeL",{},[6814],{"_33":2751,"_2788":6815,"_2790":6816,"_39":6817,"_67":66},[390,2889],[1300,2890],{},"send change after a block → publishBlocked === null",{"_29":6820,"_31":6821},[],{"_33":2680,"_35":6822,"_37":1366,"_39":6823,"_63":6824,"_65":6829,"_67":66},"40Tzj3wj",{},[6825],{"_33":2751,"_2788":6826,"_2790":6827,"_39":6828,"_67":66},[390,2806],[2889,2817],{},"send publish.blocked.dismiss → publishBlocked === null",{"_33":2680,"_35":6831,"_37":1366,"_39":6832,"_63":6833,"_65":6839,"_67":66},"HDW465zo",{"_2719":2972},[6834],{"_33":2751,"_2788":6835,"_2790":6836,"_39":6838,"_67":66},[144],[6837],38,{},"document-machine.publish-guard.test.ts:",{"_29":6841,"_31":6842},[],{"_33":2680,"_35":6843,"_37":1366,"_39":6844,"_63":6845,"_65":6852,"_67":66},"HsP1ln6P",{},[6846],{"_33":2751,"_2788":6847,"_2790":6849,"_39":6851,"_67":66},[144,6365,6848],106,[2918,6369,6850],145,{},"PublishPopoverBody test (or a small RTL test in frontend/apps/desktop): render with mocked snapshot where publishBlocked.reason === 'draft-links' → asserts the error string is visible, publish button disabled.",{"_33":3020,"_35":6854,"_37":1366,"_39":6855,"_63":6856,"_65":6857,"_67":66},"Qo5na567",{"_2719":2972},[],"5. Tests",{"_33":3020,"_35":6859,"_37":1366,"_39":6860,"_63":6861,"_65":6862,"_67":66},"IisB1fL7",{"_2719":243},[],"Implementation steps",{"_29":6864,"_31":6956},[6865,6876,6887,6898],{"_29":6866,"_31":6867},[],{"_33":2680,"_35":6868,"_37":1366,"_39":6869,"_63":6870,"_65":6875,"_67":66},"RnTdNQmy",{},[6871],{"_33":2751,"_2788":6872,"_2790":6873,"_39":6874,"_67":66},[144],[491],{},"pnpm --filter @shm/shared test — covers helper + machine transition tests.",{"_29":6877,"_31":6878},[],{"_33":2680,"_35":6879,"_37":1366,"_39":6880,"_63":6881,"_65":6886,"_67":66},"FBHtUZlG",{},[6882],{"_33":2751,"_2788":6883,"_2790":6884,"_39":6885,"_67":66},[144],[3243],{},"pnpm --filter @shm/desktop test:unit — covers popover render test.",{"_29":6888,"_31":6889},[],{"_33":2680,"_35":6890,"_37":1366,"_39":6891,"_63":6892,"_65":6897,"_67":66},"aWe0gplQ",{},[6893],{"_33":2751,"_2788":6894,"_2790":6895,"_39":6896,"_67":66},[144],[912],{},"pnpm typecheck — confirm new event payload + context shape propagate cleanly.",{"_29":6899,"_31":6951},[6900,6911,6923,6930,6937,6944],{"_29":6901,"_31":6902},[],{"_33":2680,"_35":6903,"_37":1366,"_39":6904,"_63":6905,"_65":6910,"_67":66},"tN3wgrvC",{},[6906],{"_33":2751,"_2788":6907,"_2790":6908,"_39":6909,"_67":66},[2087],[754],{},"Start desktop: pnpm --filter @shm/desktop dev.",{"_29":6912,"_31":6913},[],{"_33":2680,"_35":6914,"_37":1366,"_39":6915,"_63":6916,"_65":6922,"_67":66},"QEZHxGhr",{},[6917],{"_33":2751,"_2788":6918,"_2790":6920,"_39":6921,"_67":66},[6919],67,[6289],{},"In an existing doc, create an embed pointing to a draft (path with - segment).",{"_29":6924,"_31":6925},[],{"_33":2680,"_35":6926,"_37":1366,"_39":6927,"_63":6928,"_65":6929,"_67":66},"gGaQjQ5N",{},[],"Click publish → popover shows inline error, publish button disabled.",{"_29":6931,"_31":6932},[],{"_33":2680,"_35":6933,"_37":1366,"_39":6934,"_63":6935,"_65":6936,"_67":66},"fo5jk6zV",{},[],"Remove the offending embed → popover error clears, publish button enables.",{"_29":6938,"_31":6939},[],{"_33":2680,"_35":6940,"_37":1366,"_39":6941,"_63":6942,"_65":6943,"_67":66},"yzAqa_-r",{},[],"Publish succeeds.",{"_29":6945,"_31":6946},[],{"_33":2680,"_35":6947,"_37":1366,"_39":6948,"_63":6949,"_65":6950,"_67":66},"00-hPm3_",{},[],"Edge: create a fresh doc with no draft refs → publish flow unchanged.",{"_33":2680,"_35":6952,"_37":1366,"_39":6953,"_63":6954,"_65":6955,"_67":66},"TigsB6o8",{"_2719":2972},[],"Manual desktop run:",{"_33":3020,"_35":6957,"_37":1366,"_39":6958,"_63":6959,"_65":6960,"_67":66},"wsQNurHS",{"_2719":3238},[],"Verification",{"_29":6962,"_31":6991},[6963,6970,6977,6984],{"_29":6964,"_31":6965},[],{"_33":2680,"_35":6966,"_37":1366,"_39":6967,"_63":6968,"_65":6969,"_67":66},"f6YF7Xp4",{},[],"Cascading publish (one-click publish of referenced drafts first) — explicitly out of scope.",{"_29":6971,"_31":6972},[],{"_33":2680,"_35":6973,"_37":1366,"_39":6974,"_63":6975,"_65":6976,"_67":66},"iv812AKn",{},[],"Auto-remove draft links — out of scope.",{"_29":6978,"_31":6979},[],{"_33":2680,"_35":6980,"_37":1366,"_39":6981,"_63":6982,"_65":6983,"_67":66},"fQg3aGKV",{},[],"Block-level highlighting / scroll-to — out of scope.",{"_29":6985,"_31":6986},[],{"_33":2680,"_35":6987,"_37":1366,"_39":6988,"_63":6989,"_65":6990,"_67":66},"UclCqUnc",{},[],"The new \"create document\" editor command itself (creates draft + inserts embed) — separate feature; this plan only covers the guard required to make that feature safe to publish around.",{"_33":3020,"_35":6992,"_37":1366,"_39":6993,"_63":6994,"_65":6995,"_67":66},"PYfihiUL",{"_2719":2972},[],"Unresolved / future work",[76],"/tech-talks/publish-guard-block-publishing-when-document-content-references-local-drafts",{"_84":1386},{},{"_90":1366,"_94":1384},{"_35":1363,"_102":51,"_52":7002,"_68":1366,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1365],1779255260573,[156,1363,1366,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/publish-guard-block-publishing-when-document-content-references-local-drafts\",\"bafyreig2xvhlz2torwid3vskvt3anr6y7a22o7mztptwm6xugaojxtb3ya\",true]",{"_117":7007,"_154":7019,"_157":7020},{"_119":7008,"_139":42,"_140":7018,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7009,"_35":7016},{"_26":7010,"_68":1392,"_69":51,"_70":7011,"_52":7012,"_78":1399,"_80":1399,"_82":7013,"_88":7014,"_90":1392,"_92":7015,"_96":97},[],[75],"/tech-talks/architecture",{"_84":1408},{},{"_90":1392,"_94":1406},{"_35":1389,"_102":51,"_52":7017,"_68":1392,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1391],1779255260507,[156,1389,1392,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/architecture\",\"bafyreifthxzl76rietqeo2l5qwltpgwdqh6y7mnhfgmqqruatkljp6tv6u\",true]",{"_117":7022,"_154":7053,"_157":7054},{"_119":7023,"_139":42,"_140":2699,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7024,"_35":7051},{"_26":7025,"_68":1601,"_69":51,"_70":7046,"_52":7047,"_78":1608,"_80":1608,"_82":7048,"_88":7049,"_90":1601,"_92":7050,"_96":97},[7026,7032,7039],{"_29":7027,"_31":7028},[],{"_33":2680,"_35":2681,"_37":1601,"_39":7029,"_63":7030,"_65":7031,"_67":66},{},[],"Ion is a self-hosted openclaw instance that Eric set up.",{"_29":7033,"_31":7034},[],{"_33":2680,"_35":7035,"_37":1601,"_39":7036,"_63":7037,"_65":7038,"_67":66},"QNhanQzH",{},[],"In the telegram interface, Eric told Ion to set up the seed hypermedia skill. Then Eric told ion to make a script which polls the feed endpoint and matches for relevant events. When an event comes in who is mentioning Ion, it will kick into action.",{"_29":7040,"_31":7041},[],{"_33":2680,"_35":7042,"_37":1601,"_39":7043,"_63":7044,"_65":7045,"_67":66},"aRNdSF49",{},[],"When the script kicks ion, it will start the LLM to start working and perform followup tasks",[72],"/tech-talks/how-ion-works",{"_84":1621},{},{"_90":1601,"_94":1619},{"_35":1598,"_102":51,"_52":7052,"_68":1601,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1600],[156,1598,1601,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/how-ion-works\",\"bafyreihsqionaxwwlpmjtevwfdmcjgazvgjalbl4j7rbr6ed3s54adpmxq\",true]",{"_117":7056,"_154":7088,"_157":7089},{"_119":7057,"_139":42,"_140":7087,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7058,"_35":7085},{"_26":7059,"_68":1443,"_69":51,"_70":7080,"_52":7081,"_78":1450,"_80":1450,"_82":7082,"_88":7083,"_90":1443,"_92":7084,"_96":97},[7060],{"_29":7061,"_31":7076},[7062,7069],{"_29":7063,"_31":7064},[],{"_33":2680,"_35":7065,"_37":1443,"_39":7066,"_63":7067,"_65":7068,"_67":66},"6ycZVYVO",{},[],"Click on some content that you see - fast-ish",{"_29":7070,"_31":7071},[],{"_33":2680,"_35":7072,"_37":1443,"_39":7073,"_63":7074,"_65":7075,"_67":66},"pj2v82-Z",{},[],"Paste a URL - slow!",{"_33":3020,"_35":2681,"_37":1443,"_39":7077,"_63":7078,"_65":7079,"_67":66},{"_2719":2972},[],"Two Workflows to Measure",[72],"/tech-talks/e2e-performance-measurement",{"_84":1463},{},{"_90":1443,"_94":1461},{"_35":1440,"_102":51,"_52":7086,"_68":1443,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1442],1779255260427,[156,1440,1443,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/e2e-performance-measurement\",\"bafyreiderdxxtyexqwoxmfh4lr5ngmmzwfzwdultxkkglwqfk6exhxob4e\",true]",{"_117":7091,"_154":7166,"_157":7167},{"_119":7092,"_139":42,"_140":7165,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7093,"_35":7163},{"_26":7094,"_68":1517,"_69":51,"_70":7158,"_52":7159,"_78":1524,"_80":1524,"_82":7160,"_88":7161,"_90":1517,"_92":7162,"_96":97},[7095,7105,7126],{"_29":7096,"_31":7097},[],{"_33":2680,"_35":2681,"_37":1517,"_39":7098,"_63":7099,"_65":7104,"_67":66},{},[7100],{"_33":2751,"_2788":7101,"_2790":7102,"_39":7103,"_67":66},[2866],[2793],{},"I have some questions about the knowlege-agent-server-setup branch",{"_29":7106,"_31":7121},[7107,7114],{"_29":7108,"_31":7109},[],{"_33":2680,"_35":7110,"_37":1517,"_39":7111,"_63":7112,"_65":7113,"_67":66},"4fYECiwU",{},[],"Very cool that we have a MCP server, we have been wanting this for a while because some people have asked about it.",{"_29":7115,"_31":7116},[],{"_33":2680,"_35":7117,"_37":1517,"_39":7118,"_63":7119,"_65":7120,"_67":66},"xkvxOx-i",{},[],"But I am not sure why it is needed for the agent project. Is this an optimization, or is it strictly necessary?",{"_33":3020,"_35":7122,"_37":1517,"_39":7123,"_63":7124,"_65":7125,"_67":66},"k-BT9Kf5",{"_2719":243},[],"About MCP",{"_29":7127,"_31":7153},[7128,7135,7146],{"_29":7129,"_31":7130},[],{"_33":2680,"_35":7131,"_37":1517,"_39":7132,"_63":7133,"_65":7134,"_67":66},"VyaAOG4z",{},[],"I am very concerned about this new API which publicly exposes the subscribe/unsubscribe features. It is kind of a red flag if anybody can subscribe or unsubscribe from any content using a public api.",{"_29":7136,"_31":7137},[],{"_33":2680,"_35":7138,"_37":1517,"_39":7139,"_63":7140,"_65":7145,"_67":66},"0EG_Knj9",{},[7141],{"_33":204,"_2788":7142,"_2790":7143,"_39":7144,"_67":7145},[144],[6675],{},"https://github.com/seed-hypermedia/seed/compare/knowledge-agent-server-setup#diff-b6d30057efa25c2fb6736ed8531a61e21cbca45732c079fd9f2f03ed493f1b9aR64-R66",{"_29":7147,"_31":7148},[],{"_33":2680,"_35":7149,"_37":1517,"_39":7150,"_63":7151,"_65":7152,"_67":66},"sHWid3Qb",{},[],"Instead of doing this, can we just use the gRPC skill, which is designed to give an agent private/secure control over a daemon.",{"_33":3020,"_35":7154,"_37":1517,"_39":7155,"_63":7156,"_65":7157,"_67":66},"1q-ut98-",{"_2719":243},[],"Subscribe+Unsubscribe Exposure via API",[72],"/tech-talks/feedback-on-knowledge-agent-server-setup",{"_84":1537},{},{"_90":1517,"_94":1535},{"_35":1514,"_102":51,"_52":7164,"_68":1517,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1516],1779255260421,[156,1514,1517,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/feedback-on-knowledge-agent-server-setup\",\"bafyreiesnlnkh5tpoksvkzfgy3zxicur2kp7eb6wbtuovmbfbl34d6hf4i\",true]",{"_117":7169,"_154":7188,"_157":7189},{"_119":7170,"_139":42,"_140":7187,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7171,"_35":7185},{"_26":7172,"_68":1495,"_69":51,"_70":7180,"_52":7181,"_78":1502,"_80":1502,"_82":7182,"_88":7183,"_90":1495,"_92":7184,"_96":97},[7173],{"_29":7174,"_31":7175},[],{"_33":6334,"_35":7176,"_37":1495,"_39":7177,"_63":7178,"_65":66,"_67":7179},"cHfWYPNl",{"_2719":243},[],"ipfs://bafybeidn7uo3wtmkorz7lekhi7m4dundeoyjiwjt3qxlged4dsigguljj4",[72],"/tech-talks/new-comment-workflow-diagram",{"_84":1511},{},{"_90":1495,"_94":1509},{"_35":1492,"_102":51,"_52":7186,"_68":1495,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1494],1779255260545,[156,1492,1495,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/new-comment-workflow-diagram\",\"bafyreifo5ospgt523sosuiswshnl4l2kfqhqz3bn6qn7fin2z6mimkp6ze\",true]",{"_117":7191,"_154":7377,"_157":7378},{"_119":7192,"_139":42,"_140":7376,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7193,"_35":7374},{"_26":7194,"_68":2282,"_69":51,"_70":7369,"_52":7370,"_78":2289,"_80":2289,"_82":7371,"_88":7372,"_90":2282,"_92":7373,"_96":97},[7195,7202,7244,7258,7341,7355],{"_29":7196,"_31":7197},[],{"_33":2680,"_35":7198,"_37":2282,"_39":7199,"_63":7200,"_65":7201,"_67":66},"t80_FHBa",{},[],"This will help us conceptually model the Seed data within a given node.",{"_29":7203,"_31":7239},[7204,7211,7218,7225,7232],{"_29":7205,"_31":7206},[],{"_33":2680,"_35":7207,"_37":2282,"_39":7208,"_63":7209,"_65":7210,"_67":66},"yWlRg6Br",{},[],"Document",{"_29":7212,"_31":7213},[],{"_33":2680,"_35":7214,"_37":2282,"_39":7215,"_63":7216,"_65":7217,"_67":66},"44PUqsfG",{},[],"Contact",{"_29":7219,"_31":7220},[],{"_33":2680,"_35":7221,"_37":2282,"_39":7222,"_63":7223,"_65":7224,"_67":66},"DiWnhuz9",{},[],"Comment",{"_29":7226,"_31":7227},[],{"_33":2680,"_35":7228,"_37":2282,"_39":7229,"_63":7230,"_65":7231,"_67":66},"0C0XhIg7",{},[],"Capability (in theory)",{"_29":7233,"_31":7234},[],{"_33":2680,"_35":7235,"_37":2282,"_39":7236,"_63":7237,"_65":7238,"_67":66},"PYJSfoA8",{},[],"Profile",{"_33":2680,"_35":7240,"_37":2282,"_39":7241,"_63":7242,"_65":7243,"_67":66},"hItc2mBR",{"_2719":2972},[],"In SHM we have several types of things that can change:",{"_29":7245,"_31":7253},[7246],{"_29":7247,"_31":7248},[],{"_33":2680,"_35":7249,"_37":2282,"_39":7250,"_63":7251,"_65":7252,"_67":66},"kWp7DS_C",{},[],"Currently we only index based on the query. But we should also have a source of truth for data that is independent of the query. For example the search and activity returns lots of data and we should cache those results, but we should also organize the data that is returned in a normalized structure so that the same data can be immediately shown to the user in other contexts",{"_33":3020,"_35":7254,"_37":2282,"_39":7255,"_63":7256,"_65":7257,"_67":66},"0PvLUQel",{"_2719":243},[],"Query based Normalization",{"_29":7259,"_31":7336},[7260],{"_29":7261,"_31":7331},[7262,7317],{"_29":7263,"_31":7312},[7264,7298],{"_29":7265,"_31":7293},[7266,7280],{"_29":7267,"_31":7275},[7268],{"_29":7269,"_31":7270},[],{"_33":2680,"_35":7271,"_37":2282,"_39":7272,"_63":7273,"_65":7274,"_67":66},"EXJ3CWnL",{},[],"Pointer to the most recent version, which is saved in the immutable data cache",{"_33":2680,"_35":7276,"_37":2282,"_39":7277,"_63":7278,"_65":7279,"_67":66},"pMHaugxF",{"_2719":2972},[],"Contact, Comment, Capability",{"_29":7281,"_31":7289},[7282],{"_29":7283,"_31":7284},[],{"_33":2680,"_35":7285,"_37":2282,"_39":7286,"_63":7287,"_65":7288,"_67":66},"2Kvt_R3F",{},[],"May be a ref, deleted, or redirected.",{"_33":2680,"_35":7290,"_37":2282,"_39":7291,"_63":7292,"_65":7210,"_67":66},"qO0f-bP0",{"_2719":2972},[],{"_33":2680,"_35":7294,"_37":2282,"_39":7295,"_63":7296,"_65":7297,"_67":66},"vUzFPEqM",{"_2719":2972},[],"Index by Path string:",{"_29":7299,"_31":7307},[7300],{"_29":7301,"_31":7302},[],{"_33":2680,"_35":7303,"_37":2282,"_39":7304,"_63":7305,"_65":7306,"_67":66},"Gv31eSgS",{},[],"Contains metadata, or may be redirected",{"_33":2680,"_35":7308,"_37":2282,"_39":7309,"_63":7310,"_65":7311,"_67":66},"QUU16mNS",{"_2719":2972},[],"Profile - special singleton resource about this Account UID",{"_33":2680,"_35":7313,"_37":2282,"_39":7314,"_63":7315,"_65":7316,"_67":66},"KA0Oaf-X",{"_2719":2972},[],"Mutable Data - Indexed by Account UID",{"_29":7318,"_31":7326},[7319],{"_29":7320,"_31":7321},[],{"_33":2680,"_35":7322,"_37":2282,"_39":7323,"_63":7324,"_65":7325,"_67":66},"oe_2KJi7",{},[],"CIDs of any blobs",{"_33":2680,"_35":7327,"_37":2282,"_39":7328,"_63":7329,"_65":7330,"_67":66},"299YOiWc",{"_2719":2972},[],"Immutable Data",{"_33":2680,"_35":7332,"_37":2282,"_39":7333,"_63":7334,"_65":7335,"_67":66},"Osqa5xcC",{"_2719":2972},[],"The normalized cache would have the following structure",{"_33":3020,"_35":7337,"_37":2282,"_39":7338,"_63":7339,"_65":7340,"_67":66},"NRKmvaNq",{"_2719":243},[],"Normalized Data Structure",{"_29":7342,"_31":7350},[7343],{"_29":7344,"_31":7345},[],{"_33":2680,"_35":7346,"_37":2282,"_39":7347,"_63":7348,"_65":7349,"_67":66},"exu9RhrJ",{},[],"Some daemon endpoints do not provide all the information about redirected or deleted documents, and about redirected profiles. This makes it impossible to normalize the data correctly on the client, and I believe this is a source of many bugs.",{"_33":3020,"_35":7351,"_37":2282,"_39":7352,"_63":7353,"_65":7354,"_67":66},"_OJ5wyTp",{"_2719":243},[],"One very big problem with this",{"_29":7356,"_31":7364},[7357],{"_29":7358,"_31":7359},[],{"_33":2680,"_35":7360,"_37":2282,"_39":7361,"_63":7362,"_65":7363,"_67":66},"wwIP0ypd",{},[],"Basically when some data changes (as a result of user mutation, or new data that was synced), we need to invalidate all the places that data is shown. We should aggressively invalidate things like activity and search because we don't easily know if those results changed. And we should have fine-grained invalidation of the normalized data store",{"_33":3020,"_35":7365,"_37":2282,"_39":7366,"_63":7367,"_65":7368,"_67":66},"Qi5_lh6r",{"_2719":243},[],"Invalidation",[72],"/tech-talks/normalized-client-data",{"_84":2301},{},{"_90":2282,"_94":2299},{"_35":2279,"_102":51,"_52":7375,"_68":2282,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2281],1779255260530,[156,2279,2282,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/normalized-client-data\",\"bafy2bzacear5sxlembjyyhl3alhxrw252agxn2jgjlhxdryqeiykcmpgghccs\",true]",{"_117":7380,"_154":7687,"_157":7688},{"_119":7381,"_139":42,"_140":7686,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7382,"_35":7684},{"_26":7383,"_68":1572,"_69":51,"_70":7678,"_52":7679,"_78":185,"_80":7680,"_82":7681,"_88":7682,"_90":1579,"_92":7683,"_96":97},[7384,7654,7660],{"_29":7385,"_31":7650},[7386,7393,7444,7602],{"_29":7387,"_31":7388},[],{"_33":2680,"_35":7389,"_37":1572,"_39":7390,"_63":7391,"_65":7392,"_67":66},"7speKh92",{},[],"Two cheap tools every contributor should know — a terminal monitor for resource usage, and the app's own /debug page for counters, traces, and profiles.",{"_29":7394,"_31":7439},[7395,7406,7414,7421],{"_29":7396,"_31":7397},[],{"_33":2680,"_35":7398,"_37":1572,"_39":7399,"_63":7400,"_65":7405,"_67":66},"vS0SMU9M",{},[7401],{"_33":2751,"_2788":7402,"_2790":7403,"_39":7404,"_67":66},[882,1182,3243,2817],[1300,2839,6567,6289],{},"Launch htop (or top) and filter for seed (F4 in htop, o COMMAND=seed in top). On desktop the app runs as several processes: the Electron main process, one or more renderers, and a spawned Go daemon child. Look at the %CPU and RES columns to see which one is eating resources.",{"_29":7407,"_31":7408},[],{"_33":6334,"_35":7409,"_37":1572,"_39":7410,"_63":7411,"_65":7412,"_67":7413},"MjmzLNBk",{"_2719":243},[],"htop filtered to the seed processes","ipfs://bafkreig5n7l3avhxm2ptb4q4rj3rpj6z6jjow6halssxtdijqx7orumeqi",{"_29":7415,"_31":7416},[],{"_33":2680,"_35":7417,"_37":1572,"_39":7418,"_63":7419,"_65":7420,"_67":66},"YtsCq9SM",{},[],"Sort by MEM% to catch renderer leaks fast, by %CPU to catch runaway loops.",{"_29":7422,"_31":7423},[],{"_33":2680,"_35":7424,"_37":7425,"_39":7426,"_63":7427,"_65":7438,"_67":66},"DLFicivF","bafyreidgm6ametkjlvawby3lp22oem3jlawniaycyzo532aslfhsjims4e",{},[7428,7432],{"_33":3084,"_2788":7429,"_2790":7430,"_39":7431,"_67":66},[144],[2805],{},{"_33":2751,"_2788":7433,"_2790":7435,"_39":7437,"_67":66},[7434],272,[7436],278,{},"Reading CPU%: by default both tools show _Irix mode_ — CPU% is per core, so on an 8-core machine 100% means one full core pinned, and 200% is two cores, i.e. 25% of total capacity. If you'd rather see it normalized to total capacity (so the same 200% shows as 25%), press Ctrl+I in htop to toggle Irix mode off.",{"_33":3020,"_35":7440,"_37":1572,"_39":7441,"_63":7442,"_65":7443,"_67":66},"fMZpDNVG",{"_2719":243},[],"1. CPU & memory with top / htop",{"_29":7445,"_31":7597},[7446,7453,7481,7488,7496,7503,7570],{"_29":7447,"_31":7448},[],{"_33":2680,"_35":7449,"_37":1572,"_39":7450,"_63":7451,"_65":7452,"_67":66},"-TV9rX55",{},[],"The embedded daemon exposes an HTTP debug surface on localhost. The port depends on the build:",{"_29":7454,"_31":7477},[7455,7466],{"_29":7456,"_31":7457},[],{"_33":2680,"_35":7458,"_37":7425,"_39":7459,"_63":7460,"_65":7465,"_67":66},"erctG1of",{},[7461],{"_33":3084,"_2788":7462,"_2790":7463,"_39":7464,"_67":66},[2839],[783],{},"Production builds: http://localhost:56001/",{"_29":7467,"_31":7468},[],{"_33":2680,"_35":7469,"_37":7425,"_39":7470,"_63":7471,"_65":7476,"_67":66},"2fUfPZZD",{},[7472],{"_33":3084,"_2788":7473,"_2790":7474,"_39":7475,"_67":66},[2965],[6571],{},"Dev builds: http://localhost:58001/",{"_33":2680,"_35":7478,"_37":1572,"_39":7479,"_63":7480,"_65":66,"_67":66},"kNrPwSxe",{"_2719":2972},[],{"_29":7482,"_31":7483},[],{"_33":2680,"_35":7484,"_37":1572,"_39":7485,"_63":7486,"_65":7487,"_67":66},"98X_XKdp",{},[],"Opening the root shows an index page with links to every debug handler:",{"_29":7489,"_31":7490},[],{"_33":6334,"_35":7491,"_37":1572,"_39":7492,"_63":7493,"_65":7494,"_67":7495},"hAkzVpyQ",{"_2719":243},[],"Root debug page listing Debug/Logs, Debug/Vars, Debug/Pprof, Debug/Traces and the expvar counters","ipfs://bafkreicfovigw3wb4huhuepjsonmea5nxtez5lnds6c4zkr6ta5dfyy65e",{"_29":7497,"_31":7498},[],{"_33":2680,"_35":7499,"_37":1572,"_39":7500,"_63":7501,"_65":7502,"_67":66},"P6dyoidy",{},[],"The ones that matter day-to-day:",{"_29":7504,"_31":7566},[7505,7525,7544,7555],{"_29":7506,"_31":7507},[],{"_33":2680,"_35":7508,"_37":1572,"_39":7509,"_63":7510,"_65":7524,"_67":66},"WxclwzNg",{},[7511,7516],{"_33":3084,"_2788":7512,"_2790":7513,"_39":7515,"_67":66},[144],[7514],10,{},{"_33":2751,"_2788":7517,"_2790":7519,"_39":7523,"_67":66},[7518,2851,6400,6547],49,[6612,7520,7521,7522],79,103,122,{},"Debug/Vars — live expvar counters per subsystem (seed_auth, seed_discover_mount, seed_entity_resolution, seed_merkle_clock, …). Refresh the page to watch counters tick; useful for spotting hot paths or stuck syncing.",{"_29":7526,"_31":7527},[],{"_33":2680,"_35":7528,"_37":1572,"_39":7529,"_63":7530,"_65":7543,"_67":66},"zrDQYDc-",{},[7531,7535],{"_33":3084,"_2788":7532,"_2790":7533,"_39":7534,"_67":66},[144],[1300],{},{"_33":2751,"_2788":7536,"_2790":7539,"_39":7542,"_67":66},[6382,6670,7537,7538],156,162,[2824,7540,7541,6403],128,159,{},"Debug/Pprof — Go's profiler. Grab a snapshot from a terminal: go tool pprof http://localhost:56001/debug/pprof/heap (or /profile for a 30s CPU sample). Use top / web inside pprof to find the allocators.",{"_29":7545,"_31":7546},[],{"_33":2680,"_35":7547,"_37":7425,"_39":7548,"_63":7549,"_65":7554,"_67":66},"ZeY_zVxE",{},[7550],{"_33":3084,"_2788":7551,"_2790":7552,"_39":7553,"_67":66},[144],[2965],{},"Debug/Traces — OpenTelemetry span viewer. Every gRPC call and background job emits a span with timing. Pick a family to jump to slow ops, expand a span to see its children and their durations.",{"_29":7556,"_31":7557},[],{"_33":2680,"_35":7558,"_37":7425,"_39":7559,"_63":7560,"_65":7565,"_67":66},"7JfNpk2n",{},[7561],{"_33":3084,"_2788":7562,"_2790":7563,"_39":7564,"_67":66},[144],[7514],{},"Debug/Logs — tail of the application log, same content as stderr but browsable and filterable.",{"_33":2680,"_35":7567,"_37":1572,"_39":7568,"_63":7569,"_65":66,"_67":66},"n1SmT6eP",{"_2719":2972},[],{"_29":7571,"_31":7592},[7572,7584],{"_29":7573,"_31":7574},[],{"_33":2680,"_35":7575,"_37":1572,"_39":7576,"_63":7577,"_65":7583,"_67":66},"bdw2IOsP",{},[7578],{"_33":3084,"_2788":7579,"_2790":7580,"_39":7582,"_67":66},[2806,340],[2853,7581],178,{},"The traces page also exposes a per-category percentiles table (count, p50, p75, p90, p99, p99.9, p99.99, max) aggregated across every recent span. We highlight the critical paths — rows whose tail latency (p99 and above) blows past its budget are coloured red/orange, so regressions jump out at a glance without having to scroll through individual spans. Click a category to drill into its traces.",{"_29":7585,"_31":7586},[],{"_33":6334,"_35":7587,"_37":1572,"_39":7588,"_63":7589,"_65":7590,"_67":7591},"HLqci8jQ",{"_2719":243},[],"trc per-category percentiles with critical paths highlighted in red and orange","ipfs://bafkreib6qpu2zp3u6mzhlvd4gkjhtiimvsxkqocvhowtrqabf74e7dxs7u",{"_33":3020,"_35":7593,"_37":1572,"_39":7594,"_63":7595,"_65":7596,"_67":66},"NWVv7zOW",{"_2719":243},[],"Per-category percentiles",{"_33":3020,"_35":7598,"_37":1572,"_39":7599,"_63":7600,"_65":7601,"_67":66},"dO3nKkCp",{"_2719":243},[],"2. The local /debug page",{"_29":7603,"_31":7645},[7604,7638],{"_29":7605,"_31":7634},[7606,7613,7620,7627],{"_29":7607,"_31":7608},[],{"_33":2680,"_35":7609,"_37":1572,"_39":7610,"_63":7611,"_65":7612,"_67":66},"JP3aFqRG",{},[],"Reproduce the slow action in the UI.",{"_29":7614,"_31":7615},[],{"_33":2680,"_35":7616,"_37":1572,"_39":7617,"_63":7618,"_65":7619,"_67":66},"tnk2_eaO",{},[],"Open Debug/Traces, scan the percentiles table for anything highlighted, and sort by duration — the long ones are your targets.",{"_29":7621,"_31":7622},[],{"_33":2680,"_35":7623,"_37":1572,"_39":7624,"_63":7625,"_65":7626,"_67":66},"R_hMCDmq",{},[],"Drill into a span to see which sub-op took the time (DB, p2p fetch, blob verify, etc.).",{"_29":7628,"_31":7629},[],{"_33":2680,"_35":7630,"_37":1572,"_39":7631,"_63":7632,"_65":7633,"_67":66},"Yk_kkmcq",{},[],"If the hot spot is CPU-bound, follow up with a 30s pprof profile. If it's a counter spike, cross-check Debug/Vars.",{"_33":2680,"_35":7635,"_37":1572,"_39":7636,"_63":7637,"_65":66,"_67":66},"WYhsOPJ3",{"_2719":3238},[],{"_29":7639,"_31":7640},[],{"_33":2680,"_35":7641,"_37":1572,"_39":7642,"_63":7643,"_65":7644,"_67":66},"PV-fafSc",{},[],"Three links and a terminal — grab these first before reaching for heavier tooling.",{"_33":3020,"_35":7646,"_37":1572,"_39":7647,"_63":7648,"_65":7649,"_67":66},"5KuDhNqA",{"_2719":243},[],"3. A typical trace-a-problem loop",{"_33":3020,"_35":7651,"_37":1572,"_39":7652,"_63":7653,"_65":1592,"_67":66},"1KhgslpF",{"_2719":243},[],{"_29":7655,"_31":7656},[],{"_33":2680,"_35":7657,"_37":1572,"_39":7658,"_63":7659,"_65":66,"_67":66},"CPLBYu6v",{},[],{"_29":7661,"_31":7673},[7662],{"_29":7663,"_31":7664},[],{"_33":2680,"_35":7665,"_37":1572,"_39":7666,"_63":7667,"_65":7672,"_67":66},"-aQp9ym7",{},[7668],{"_33":2751,"_2788":7669,"_2790":7670,"_39":7671,"_67":66},[1835],[2806],{},"Run ./scripts/profile-daemon.ts while the desktop app is running",{"_33":3020,"_35":7674,"_37":1572,"_39":7675,"_63":7676,"_65":7677,"_67":66},"Nv_SVf7V",{"_2719":243},[],"Daemon Profiler",[72,73],"/tech-talks/profile-local-performance","2026-05-07T10:11:34.410Z",{"_84":1592,"_86":1593,"_1594":1595},{},{"_90":1579,"_94":1590},{"_35":1569,"_102":51,"_52":7685,"_68":1572,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1571],1779255260588,[156,1569,1572,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/profile-local-performance\",\"bafy2bzaceagqvtmndhlt4q53miypwqvuct5t7wxplzekc2hbvspverilhtoei\",true]",{"_117":7690,"_154":7956,"_157":7957},{"_119":7691,"_139":42,"_140":7955,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7692,"_35":7953},{"_26":7693,"_68":1627,"_69":51,"_70":7947,"_52":7948,"_78":185,"_80":7949,"_82":7950,"_88":7951,"_90":1579,"_92":7952,"_96":97},[7694,7733,7780,7834,7902],{"_29":7695,"_31":7696},[],{"_33":2680,"_35":7697,"_37":7698,"_39":7699,"_63":7700,"_65":7732,"_67":66},"5euaGDyB","bafy2bzaced3asrwdvyrxs7e3wsc44okby5vdfvvxcxtwxadkevcohkmq5jhdi",{},[7701,7708,7715,7721,7727],{"_33":204,"_2788":7702,"_2790":7704,"_39":7706,"_67":7707},[7703],26,[7705],104,{},"https://github.com/seed-hypermedia/seed/pull/377",{"_33":2727,"_2788":7709,"_2790":7711,"_39":7713,"_67":7714},[7710],109,[7712],110,{},"hm://z6Mkvz9TgGtv9zsGsdrksfNk1ajbFancgHREJEz3Y2HsAVdk/:profile?v=bafy2bzaceaf5y2554kmdly7yz55fowqum4546bpa2gmi5gntflhlf4gaomdg6&l",{"_33":2727,"_2788":7716,"_2790":7718,"_39":7719,"_67":7720},[7717],111,[6791],{},"hm://z6MkgisVMELvqnsCo3dYmtVpy8PiqPGMVwfAyBWFn84vebq4/:profile",{"_33":2727,"_2788":7722,"_2790":7723,"_39":7725,"_67":7726},[6574],[7724],114,{},"hm://z6MkgYR76i3w2Xc2fcvgFJWfYjsop6YwUonDhQx3AdLmQ4BQ/:profile",{"_33":2727,"_2788":7728,"_2790":7729,"_39":7730,"_67":7731},[2824],[6366],{},"hm://z6MkrbYsRzKb1VABdvhsDSAk6JK8fAszKsyHhcaZigYeWCou/:profile?v=bafy2bzacecoevvu2ebpntbrhm552uqp3ag5vrxvukpk7a4vvfmhazkk7smu5y&l","Discussion extracted from PR #377: feat(cli): switch default draft format to JSON with --markdown option. cc ",{"_29":7734,"_31":7774},[7735,7746,7763],{"_29":7736,"_31":7737},[],{"_33":2680,"_35":7738,"_37":7698,"_39":7739,"_63":7740,"_65":7745,"_67":66},"XFTldrau",{},[7741],{"_33":3084,"_2788":7742,"_2790":7743,"_39":7744,"_67":66},[144],[649],{},"Julio: What's reason behind changing the default draft format in the CLI? Right now everything we produce with the CLI is markdown first, since it's LLM's format of choice. Also, markdown can be further amended and updated manually by the user. Or even created by the user entirely. The drawback is that markdown is not as rich as JSON so not all block types can be represented in .MD files unless we do nastier things with HTML tagging. But the CLI currently only supports basic blocks. So I wonder if you plan to add more blocks to the CLI or what was the purpose.",{"_29":7747,"_31":7748},[],{"_33":2680,"_35":7749,"_37":7698,"_39":7750,"_63":7751,"_65":7762,"_67":66},"4qyShF8r",{},[7752,7756],{"_33":3084,"_2788":7753,"_2790":7754,"_39":7755,"_67":66},[144],[390],{},{"_33":204,"_2788":7757,"_2790":7758,"_39":7760,"_67":7761},[2824],[7759],132,{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/human-interface-library/cli-design-principles","Eric: I agree that the JSON is a better format for saving. But the markdown CLI behavior by default is part of our design principles.",{"_29":7764,"_31":7765},[],{"_33":2680,"_35":7766,"_37":7698,"_39":7767,"_63":7768,"_65":7773,"_67":66},"k3NtlaJ-",{},[7769],{"_33":3084,"_2788":7770,"_2790":7771,"_39":7772,"_67":66},[144],[649],{},"Julio: The problem is, how do we reconcile those two? Right now the CLI saves it in .md AND also writes the index JSON so that the app can see this too (internally the desktop app parses it using the parser in the client SDK). The desktop app still saves them in JSON because only the desktop app can generate rich documents only supported by JSON format.",{"_33":3020,"_35":7775,"_37":7776,"_39":7777,"_63":7778,"_65":7779,"_67":66},"RcPQpR9r","bafy2bzacedqqywhkzx6ejcpd3pp6wzorh4pmgejfianro34iajdgmyzyg4r2q",{"_2719":243},[],"CLI Draft Format",{"_29":7781,"_31":7829},[7782,7793,7800,7811,7822],{"_29":7783,"_31":7784},[],{"_33":2680,"_35":7785,"_37":7698,"_39":7786,"_63":7787,"_65":7792,"_67":66},"ra3iTEdC",{},[7788],{"_33":3084,"_2788":7789,"_2790":7790,"_39":7791,"_67":66},[144],[390],{},"Eric: I'm not sure it's a good idea for the CLI to work with the same drafts folder as the desktop app. Helpful for us I think, but I think it's generally a bad practice to use the same signing keys and drafts between CLI and desktop because usually the desktop is operated by a human and the CLI is operated by a bot or a script, who should have a different identity.",{"_29":7794,"_31":7795},[],{"_33":2680,"_35":7796,"_37":7698,"_39":7797,"_63":7798,"_65":7799,"_67":66},"YADe9nP4",{},[],"I guess it would be good to use the same draft saving format and code. Then maybe there is a CLI flag which allows you to specify the drafts folder, in case the user really does want to use the same one as desktop.",{"_29":7801,"_31":7802},[],{"_33":2680,"_35":7803,"_37":7698,"_39":7804,"_63":7805,"_65":7810,"_67":66},"bypJKlMB",{},[7806],{"_33":3084,"_2788":7807,"_2790":7808,"_39":7809,"_67":66},[144],[390],{},"Eric: I don't agree that the CLI should have two formats of draft saving. What is the benefit of saving the drafts as markdown? I believe that the CLI should output markdown to the user (following our design principle), but it can use the \"proper\" data format underneath.",{"_29":7812,"_31":7813},[],{"_33":2680,"_35":7814,"_37":7698,"_39":7815,"_63":7816,"_65":7821,"_67":66},"c1rO5vNw",{},[7817],{"_33":3084,"_2788":7818,"_2790":7819,"_39":7820,"_67":66},[144],[649],{},"Julio: Actually we currently accept a path override via flag. But the default path is the seed path. I wanted to have a global place for drafts since I did not want drafts scattered among directories depending on where you invoked the CLI from.",{"_29":7823,"_31":7824},[],{"_33":2680,"_35":7825,"_37":7698,"_39":7826,"_63":7827,"_65":7828,"_67":66},"47tJRwLP",{},[],"What was described (blank draft seen on the desktop app) is clearly a bug not an architectural issue IMO.",{"_33":3020,"_35":7830,"_37":7776,"_39":7831,"_63":7832,"_65":7833,"_67":66},"ZjPh7K6k",{"_2719":243},[],"Shared Drafts Folder",{"_29":7835,"_31":7897},[7836,7847,7854,7861,7872,7879,7886],{"_29":7837,"_31":7838},[],{"_33":2680,"_35":7839,"_37":7698,"_39":7840,"_63":7841,"_65":7846,"_67":66},"KsubjVch",{},[7842],{"_33":3084,"_2788":7843,"_2790":7844,"_39":7845,"_67":66},[144],[649],{},"Julio: On the other hand, Eric, imposing limitations on the tooling about what keys to use and all of that I don't think it's a very robust solution. I don't even know what the problem is. Allowing the tools to use any keys the user wants to use on them?",{"_29":7848,"_31":7849},[],{"_33":2680,"_35":7850,"_37":7698,"_39":7851,"_63":7852,"_65":7853,"_67":66},"5nwBQ8wI",{},[],"This separation between CLI (bot) and desktop (human) is greyer than one may anticipate. I can perfectly use the CLI myself (just like I use curl manually), and I can also use the chatbot in the app to generate drafts totally in automatic mode (without looking at the text generated). So I don't see a clear bot/human separation. Maybe we need to step back and think about our broader policy on this matter.",{"_29":7855,"_31":7856},[],{"_33":2680,"_35":7857,"_37":7698,"_39":7858,"_63":7859,"_65":7860,"_67":66},"9wCDkJZ5",{},[],"If you want to co-sign a document with a bot, your flow of creating the first draft with a bot key and then iterate over with a human key could work. But that's a user's decision. Let's take the git commit comment in Claude as an example. Claude wants to add this annoying note \"co-authored with Claude Code\" or something like that and I don't like it at all. I want to receive full credit (and responsibility) of what goes there, even if I did not look at any single line of code that was committed. If git forced me to use a different bot key I would be quite annoyed.",{"_29":7862,"_31":7863},[],{"_33":2680,"_35":7864,"_37":7698,"_39":7865,"_63":7866,"_65":7871,"_67":66},"-kcxKDhb",{},[7867],{"_33":3084,"_2788":7868,"_2790":7869,"_39":7870,"_67":66},[144],[390],{},"Eric: I believe the major benefit of Seed with agents is that we can use changes to track attribution between agent and human. So, when the agent completes their change, it gets signed (no longer in draft mode). Then when the human makes improvements on the agent's work, you can see exactly what was changed.",{"_29":7873,"_31":7874},[],{"_33":2680,"_35":7875,"_37":7698,"_39":7876,"_63":7877,"_65":7878,"_67":66},"K9nPLIWC",{},[],"Of course I should be able to see that an agent was \"steered\" by a certain human, and ideally I would also see the prompts that were used to create the agent's output. So that way I can see how the humans on my team are using AI. In 2026 I hate wondering \"is this team member really thinking this way, or is this just a LLM hallucination.\"",{"_29":7880,"_31":7881},[],{"_33":2680,"_35":7882,"_37":7698,"_39":7883,"_63":7884,"_65":7885,"_67":66},"3IQNSCca",{},[],"And, I think that if you really do want to use your personal keys to sign LLM-generated content, that should be possible (but discouraged with the default UX).",{"_29":7887,"_31":7888},[],{"_33":2680,"_35":7889,"_37":7698,"_39":7890,"_63":7891,"_65":7896,"_67":66},"juLNt1fS",{},[7892],{"_33":3084,"_2788":7893,"_2790":7894,"_39":7895,"_67":66},[144],[649],{},"Julio: There is a practical angle to key separation that makes it harder than it looks. Today the human is the one registered as official member of the sites — capabilities are issued to my key. If I try to delegate to a separate bot key, either the bot cannot write on the same sites my \"master\" key can, or I have to re-issue capabilities to the bot on every site I am part of. That is painful enough that the easy route is to just hand the bot my own key and impersonate. Even if a users initial intent is to keep personas separate, after feeling that pain they will default to impersonation. Unless we build a full capability clone — a way to say \"this bot key inherits every capability my key has\" — the rational outcome is: whatever I can access as a real human should be available to my bots, because they are effectively controlled by me anyway.",{"_33":3020,"_35":7898,"_37":7776,"_39":7899,"_63":7900,"_65":7901,"_67":66},"YpGt9axQ",{"_2719":243},[],"Agent Attribution & Key Separation",{"_29":7903,"_31":7942},[7904,7915,7935],{"_29":7905,"_31":7906},[],{"_33":2680,"_35":7907,"_37":7698,"_39":7908,"_63":7909,"_65":7914,"_67":66},"U0up4G4j",{},[7910],{"_33":3084,"_2788":7911,"_2790":7912,"_39":7913,"_67":66},[144],[649],{},"Julio: Then, to what extent drafts in the CLI are useful? Because there are two conflicting flows:",{"_29":7916,"_31":7931},[7917,7924],{"_29":7918,"_31":7919},[],{"_33":2680,"_35":7920,"_37":7776,"_39":7921,"_63":7922,"_65":7923,"_67":66},"ffcbHh0e",{},[],"The human iterates in a code session along with a model, the content of a seed document. The output of the session is a draft that can be further visualized, amended or processed. Then, when the user is happy, it signs the first version with a \"human key.\"",{"_29":7925,"_31":7926},[],{"_33":2680,"_35":7927,"_37":7776,"_39":7928,"_63":7929,"_65":7930,"_67":66},"mhp1Aq7d",{},[],"Agent creates a first signed version of the document. A human can \"steer\" as many times as it wants, creating new versions every time. At this point, the document is being handled in the desktop app. I would add: if inside the app changes come from the chatbot agent (one of the next features) we should again use a \"bot key\" according to your reasoning Eric? If changes are manually input in the editor by a human, then use regular keys.",{"_33":2680,"_35":7932,"_37":7776,"_39":7933,"_63":7934,"_65":66,"_67":66},"KurHGO0Y",{"_2719":3238},[],{"_29":7936,"_31":7937},[],{"_33":2680,"_35":7938,"_37":7698,"_39":7939,"_63":7940,"_65":7941,"_67":66},"uhA50zC6",{},[],"The thing is, in case 1, we should instruct (via skill) the LLM to create a draft instead of a document while the opposite is true for case 2. If we believe we should encourage case 2 for users, that's fine. But why did we push so hard to have CLI drafts, then? They won't be used at all by LLMs.",{"_33":3020,"_35":7943,"_37":7776,"_39":7944,"_63":7945,"_65":7946,"_67":66},"0LAWYbCy",{"_2719":243},[],"Draft Workflows: When Are Drafts Useful?",[73],"/tech-talks/ai-flows","2026-04-22T14:28:45.764Z",{"_84":1641,"_86":1642,"_1643":1644},{},{"_90":1579,"_94":1639},{"_35":1624,"_102":51,"_52":7954,"_68":1627,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1626],1779255260540,[156,1624,1627,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/ai-flows\",\"bafy2bzaceacaitquufuecjnuatic4za2ze7ekzz3xl4vlfmgg34jztdngrede\",true]",{"_117":7959,"_154":9173,"_157":9174},{"_119":7960,"_139":42,"_140":9172,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":7961,"_35":9170},{"_26":7962,"_68":1650,"_69":51,"_70":9165,"_52":9166,"_78":1657,"_80":1657,"_82":9167,"_88":9168,"_90":1650,"_92":9169,"_96":97},[7963,8050,8385,8501,8894,8970,9137],{"_29":7964,"_31":8046},[7965,8014,8035],{"_29":7966,"_31":8009},[7967,7992],{"_29":7968,"_31":7969},[],{"_33":2680,"_35":7970,"_37":1650,"_39":7971,"_63":7972,"_65":7991,"_67":66},"RCu1D0zq",{},[7973,7977],{"_33":3084,"_2788":7974,"_2790":7975,"_39":7976,"_67":66},[144],[2966],{},{"_33":2751,"_2788":7978,"_2790":7983,"_39":7990,"_67":66},[2878,6804,7724,7537,7979,7980,7981,7982],192,352,369,401,[2893,7521,7984,7985,7986,7987,7988,7989],123,186,227,367,399,410,{},"The desktop daemon is wide-open on the LAN. backend/daemon/http.go:171 and backend/daemon/daemon.go:379 both bind \":\" (0.0.0.0) with no TLS, no auth, Access-Control-Allow-Origin: *, and WithOriginFunc(...) { return true }. Any device on the same network — and any website opened in any browser on the user's machine, via DNS rebinding — can call Daemon.SignData, Documents.CreateDocumentChange, ExportKey, etc., using the user's stored signing keys.",{"_29":7993,"_31":7994},[],{"_33":2680,"_35":7995,"_37":1650,"_39":7996,"_63":7997,"_65":8008,"_67":66},"6v_igvOz",{},[7998,8002],{"_33":3084,"_2788":7999,"_2790":8000,"_39":8001,"_67":66},[144],[7518],{},{"_33":2751,"_2788":8003,"_2790":8005,"_39":8007,"_67":66},[8004],295,[8006],335,{},"The Remix web server can't tell \"who\" is browsing, so it can't decide whether to serve a private document. Identity today lives in IndexedDB (keypairs, vault delegation blobs) on the browser side; nothing is forwarded to the server. The server talks to the site daemon anonymously via gRPC-Web (frontend/apps/web/app/client.server.ts:9).",{"_33":2680,"_35":8010,"_37":1650,"_39":8011,"_63":8012,"_65":8013,"_67":66},"8FJq1iTx",{"_2719":3238},[],"Two concrete weaknesses drive this work:",{"_29":8015,"_31":8016},[],{"_33":2680,"_35":8017,"_37":1650,"_39":8018,"_63":8019,"_65":8034,"_67":66},"ip9YpwUo",{},[8020],{"_33":2751,"_2788":8021,"_2790":8027,"_39":8033,"_67":66},[8022,8023,8024,8025,8026],300,365,429,451,466,[8028,8029,8030,8031,8032],337,409,439,463,491,{},"Goal: close the LAN/website attack surface on the desktop daemon, and give the Remix web server a way to identify the browser user and forward a per-user read capability to the daemon, without introducing new key-management primitives. Reuse what's already there: non-extractable WebCrypto keypairs (frontend/apps/web/app/auth-session.ts), signed capability blobs (proto/documents/v3alpha/access_control.proto), and the existing PublicOnly blob gate (backend/blob + backend/daemon/http.go:57).",{"_29":8036,"_31":8037},[],{"_33":2680,"_35":8038,"_37":1650,"_39":8039,"_63":8040,"_65":8045,"_67":66},"sjE-vBLR",{},[8041],{"_33":3084,"_2788":8042,"_2790":8043,"_39":8044,"_67":66},[2805],[3926],{},"Single plan, three phases, shippable independently.",{"_33":3020,"_35":8047,"_37":1650,"_39":8048,"_63":8049,"_65":6328,"_67":66},"Qw6vcjqj",{"_2719":243},[],{"_29":8051,"_31":8380},[8052,8067,8258,8340],{"_29":8053,"_31":8054},[],{"_33":2680,"_35":8055,"_37":1650,"_39":8056,"_63":8057,"_65":8066,"_67":66},"94NkKhQp",{},[8058,8062],{"_33":3084,"_2788":8059,"_2790":8060,"_39":8061,"_67":66},[144],[1057],{},{"_33":2751,"_2788":8063,"_2790":8064,"_39":8065,"_67":66},[2821],[2889],{},"Outcome: a stock seed-daemon cannot be reached by anything other than a process running as the same local user that knows the token.",{"_29":8068,"_31":8253},[8069,8106,8118,8129,8162,8213,8226,8239],{"_29":8070,"_31":8097},[8071,8086],{"_29":8072,"_31":8073},[],{"_33":2680,"_35":8074,"_37":1650,"_39":8075,"_63":8076,"_65":8085,"_67":66},"lMjrL9B4",{},[8077],{"_33":2751,"_2788":8078,"_2790":8081,"_39":8084,"_67":66},[1057,2551,7518,8079,8080,6613,6383],61,85,[2821,4245,6612,2893,6805,8082,8083],117,185,{},"Replace http.port / grpc.port integer flags with http.addr / grpc.addr string flags (127.0.0.1:55001, 127.0.0.1:55002). Keep legacy port flags as deprecated aliases that force 127.0.0.1. Default = loopback, no opt-out in Phase 1.",{"_29":8087,"_31":8088},[],{"_33":2680,"_35":8089,"_37":1650,"_39":8090,"_63":8091,"_65":8096,"_67":66},"z0BnQBnk",{},[8092],{"_33":2751,"_2788":8093,"_2790":8094,"_39":8095,"_67":66},[1835,2792],[1330,2817],{},"Add Daemon.AuthTokenPath (default /auth.token). No flag for \"disable auth\"; dev/test overrides via env only.",{"_33":2680,"_35":8098,"_37":1650,"_39":8099,"_63":8100,"_65":8105,"_67":66},"k4kP56Xt",{"_2719":2972},[8101],{"_33":2751,"_2788":8102,"_2790":8103,"_39":8104,"_67":66},[144],[1330],{},"backend/config/config.go",{"_29":8107,"_31":8108},[],{"_33":2680,"_35":8109,"_37":1650,"_39":8110,"_63":8111,"_65":8117,"_67":66},"b3dPVU9j",{},[8112],{"_33":2751,"_2788":8113,"_2790":8115,"_39":8116,"_67":66},[144,3243,8114],82,[2889,6802,7724],{},"backend/daemon/daemon.go:379 — swap net.Listen(\"tcp\", \":\"+strconv.Itoa(port)) for net.Listen(\"tcp\", cfg.GRPC.Addr).",{"_29":8119,"_31":8120},[],{"_33":2680,"_35":8121,"_37":1650,"_39":8122,"_63":8123,"_65":8128,"_67":66},"1NyR917E",{},[8124],{"_33":2751,"_2788":8125,"_2790":8126,"_39":8127,"_67":66},[144,3088],[7703,6612],{},"backend/daemon/http.go:171 — same swap; ensure Server.Addr is the loopback-scoped value.",{"_29":8130,"_31":8153},[8131,8142],{"_29":8132,"_31":8133},[],{"_33":2680,"_35":8134,"_37":1650,"_39":8135,"_63":8136,"_65":8141,"_67":66},"7q4EgSo4",{},[8137],{"_33":2751,"_2788":8138,"_2790":8139,"_39":8140,"_67":66},[2087,2818],[3243,6547],{},"On startup: if /auth.token missing, generate 32 random bytes, base64url-encode, write with 0600 (error if dir group/other-writable on unix). On Windows, set ACL to current SID.",{"_29":8143,"_31":8144},[],{"_33":2680,"_35":8145,"_37":1650,"_39":8146,"_63":8147,"_65":8152,"_67":66},"7IJm1uDW",{},[8148],{"_33":2751,"_2788":8149,"_2790":8150,"_39":8151,"_67":66},[882],[912],{},"Expose Token() for in-process readers (CLI, tests).",{"_33":2680,"_35":8154,"_37":1650,"_39":8155,"_63":8156,"_65":8161,"_67":66},"RqRVOAl9",{"_2719":2972},[8157],{"_33":2751,"_2788":8158,"_2790":8159,"_39":8160,"_67":66},[2905],[3243],{},"New file backend/daemon/authtoken.go:",{"_29":8163,"_31":8204},[8164,8176,8192],{"_29":8165,"_31":8166},[],{"_33":2680,"_35":8167,"_37":1650,"_39":8168,"_63":8169,"_65":8175,"_67":66},"6-XWNl3b",{},[8170],{"_33":2751,"_2788":8171,"_2790":8173,"_39":8174,"_67":66},[8172,754],23,[6286,2854],{},"Rejects requests whose Host header is not in {127.0.0.1:, localhost:, [::1]:} (DNS-rebinding defense).",{"_29":8177,"_31":8178},[],{"_33":2680,"_35":8179,"_37":1650,"_39":8180,"_63":8181,"_65":8191,"_67":66},"fZUx9FSe",{},[8182,8187],{"_33":2751,"_2788":8183,"_2790":8184,"_39":8186,"_67":66},[2905,7521,7759,7541],[6837,7717,2825,8185],174,{},{"_33":3084,"_2788":8188,"_2790":8189,"_39":8190,"_67":66},[783],[754],{},"Requires Authorization: Bearer on all RPCs except a small explicit allowlist (metrics, health, /debug/* gated by env, maybe /ipfs/{cid} read-only when PublicOnly=true). Reject otherwise with 401.",{"_29":8193,"_31":8194},[],{"_33":2680,"_35":8195,"_37":1650,"_39":8196,"_63":8197,"_65":8203,"_67":66},"wEMpoYIq",{},[8198],{"_33":2751,"_2788":8199,"_2790":8200,"_39":8202,"_67":66},[649,6572,2891],[3243,6240,8201],88,{},"Drops Access-Control-Allow-Origin: *. Allowlist only null (Electron file://), app://seed, and origins listed in config (empty by default).",{"_33":2680,"_35":8205,"_37":1650,"_39":8206,"_63":8207,"_65":8212,"_67":66},"DP_IrOMg",{"_2719":2972},[8208],{"_33":2751,"_2788":8209,"_2790":8210,"_39":8211,"_67":66},[144],[2836],{},"backend/daemon/http.go — wrap the mux with a middleware that:",{"_29":8214,"_31":8215},[],{"_33":2680,"_35":8216,"_37":1650,"_39":8217,"_63":8218,"_65":8225,"_67":66},"j_NReBGa",{},[8219],{"_33":2751,"_2788":8220,"_2790":8221,"_39":8224,"_67":66},[144,6286,6572],[3926,8222,8223],41,64,{},"backend/daemon/http.go:97 (WithOriginFunc) — replace return true with the same allowlist used by the CORS middleware. Same treatment for gRPC-web.",{"_29":8227,"_31":8228},[],{"_33":2680,"_35":8229,"_37":1650,"_39":8230,"_63":8231,"_65":8238,"_67":66},"Z_3ephte",{},[8232],{"_33":2751,"_2788":8233,"_2790":8235,"_39":8237,"_67":66},[144,8234],74,[2836,8236],87,{},"backend/api/apis.go:71 — add a unary + stream gRPC interceptor that reads authorization from metadata and validates against the token. Applies to all registered services. Streams too.",{"_29":8240,"_31":8241},[],{"_33":2680,"_35":8242,"_37":1650,"_39":8243,"_63":8244,"_65":8252,"_67":66},"rQt2cXZL",{},[8245],{"_33":2751,"_2788":8246,"_2790":8249,"_39":8251,"_67":66},[144,8247,8248],190,262,[3243,7986,8250],270,{},"backend/api/daemon/v1alpha/daemon.go (SignData, RegisterKey, ImportKey, ExportKey, DeleteKey, ChangeKeyName): keep the interceptor-level check; additionally log (structured) an audit record {time, method, key_name, remote_addr} to the existing logger. Read-only ListKeys can stay without audit.",{"_33":3020,"_35":8254,"_37":1650,"_39":8255,"_63":8256,"_65":8257,"_67":66},"Pt1olyWB",{"_2719":2972},[],"Changes",{"_29":8259,"_31":8335},[8260,8298,8312,8324],{"_29":8261,"_31":8289},[8262,8273],{"_29":8263,"_31":8264},[],{"_33":2680,"_35":8265,"_37":1650,"_39":8266,"_63":8267,"_65":8272,"_67":66},"YaBf49Hl",{},[8268],{"_33":2751,"_2788":8269,"_2790":8270,"_39":8271,"_67":66},[2806],[2793],{},"After spawning the child, poll /daemon/auth.token (up to ~2 s, 20 ms interval) for the file to appear, read it, cache in memory.",{"_29":8274,"_31":8275},[],{"_33":2680,"_35":8276,"_37":1650,"_39":8277,"_63":8278,"_65":8288,"_67":66},"9xTeKO3b",{},[8279,8284],{"_33":2751,"_2788":8280,"_2790":8282,"_39":8283,"_67":66},[2907,8281],84,[6612,2854],{},{"_33":3084,"_2788":8285,"_2790":8286,"_39":8287,"_67":66},[6790],[8234],{},"Expose it over a new ipcMain.handle('daemon:authToken', …) channel. Do not write to process.env (leaks to renderer devtools).",{"_33":2680,"_35":8290,"_37":1650,"_39":8291,"_63":8292,"_65":8297,"_67":66},"oCT71-T7",{"_2719":2972},[8293],{"_33":2751,"_2788":8294,"_2790":8295,"_39":8296,"_67":66},[144],[6571],{},"frontend/apps/desktop/src/daemon.ts",{"_29":8299,"_31":8300},[],{"_33":2680,"_35":8301,"_37":1650,"_39":8302,"_63":8303,"_65":8311,"_67":66},"Wnxng-mz",{},[8304],{"_33":2751,"_2788":8305,"_2790":8308,"_39":8310,"_67":66},[144,8306,6848,6676,8307],86,271,[2966,7705,2824,2549,8309],297,{},"frontend/apps/desktop/src/app-grpc.ts:14-84 — add a connectrpc interceptor (alongside loggingInterceptor, prodInter) that fetches the token via preload IPC on first use, caches, and adds Authorization: Bearer … header to every unary/stream call. Also add it to any plain fetch(DAEMON_HTTP_URL/...) used in the renderer.",{"_29":8313,"_31":8314},[],{"_33":2680,"_35":8315,"_37":1650,"_39":8316,"_63":8317,"_65":8323,"_67":66},"x2dxNyfJ",{},[8318],{"_33":2751,"_2788":8319,"_2790":8320,"_39":8322,"_67":66},[2905,8234],[2822,8321],94,{},"Preload (frontend/apps/desktop/src/preload*.ts) — contextBridge exposes a getDaemonAuthToken() that calls the IPC handler.",{"_29":8325,"_31":8326},[],{"_33":2680,"_35":8327,"_37":1650,"_39":8328,"_63":8329,"_65":8334,"_67":66},"C68PbQGO",{},[8330],{"_33":2751,"_2788":8331,"_2790":8332,"_39":8333,"_67":66},[390,1330,2552],[2836,3088,6240],{},"CLI (frontend/apps/cli, backend/cmd/seed-sqlite / pingp2p that talk to the daemon, if any) — read the token from the data dir the same way.",{"_33":3020,"_35":8336,"_37":1650,"_39":8337,"_63":8338,"_65":8339,"_67":66},"XR1knanA",{"_2719":2972},[],"Desktop Electron changes",{"_29":8341,"_31":8375},[8342,8353,8364],{"_29":8343,"_31":8344},[],{"_33":2680,"_35":8345,"_37":1650,"_39":8346,"_63":8347,"_65":8352,"_67":66},"N1V8XTQs",{},[8348],{"_33":2751,"_2788":8349,"_2790":8350,"_39":8351,"_67":66},[1835],[2806],{},"Go: backend/daemon/http_test.go — add cases: no Authorization → 401; wrong Host header → 403; correct token + Host → 200; gRPC interceptor rejects missing metadata; token file permissions (0600 on unix).",{"_29":8354,"_31":8355},[],{"_33":2680,"_35":8356,"_37":1650,"_39":8357,"_63":8358,"_65":8363,"_67":66},"FZs-BxQA",{},[8359],{"_33":2751,"_2788":8360,"_2790":8361,"_39":8362,"_67":66},[1057],[8222],{},"Go e2e (backend/daemon/daemon_e2e_test.go) — pass token through the test client; ensure existing flows still pass.",{"_29":8365,"_31":8366},[],{"_33":2680,"_35":8367,"_37":1650,"_39":8368,"_63":8369,"_65":8374,"_67":66},"1gPF32eM",{},[8370],{"_33":2751,"_2788":8371,"_2790":8372,"_39":8373,"_67":66},[7703],[6365],{},"Electron: smoke test that createGrpcWebTransport attaches the header (mock the fetch, assert).",{"_33":3020,"_35":8376,"_37":1650,"_39":8377,"_63":8378,"_65":8379,"_67":66},"CpWvxV2z",{"_2719":2972},[],"Tests",{"_33":3020,"_35":8381,"_37":1650,"_39":8382,"_63":8383,"_65":8384,"_67":66},"hBm9XsmX",{"_2719":243},[],"Phase 1 — Loopback bind + local auth token (desktop daemon hardening)",{"_29":8386,"_31":8496},[8387,8398,8476],{"_29":8388,"_31":8389},[],{"_33":2680,"_35":8390,"_37":1650,"_39":8391,"_63":8392,"_65":8397,"_67":66},"DtWiT0_P",{},[8393],{"_33":3084,"_2788":8394,"_2790":8395,"_39":8396,"_67":66},[144],[1057],{},"Outcome: the daemon accepts browser requests only from the Electron app and explicitly-paired origins; everything else is 403.",{"_29":8399,"_31":8472},[8400,8434,8441,8454,8465],{"_29":8401,"_31":8424},[8402,8413],{"_29":8403,"_31":8404},[],{"_33":2680,"_35":8405,"_37":1650,"_39":8406,"_63":8407,"_65":8412,"_67":66},"JbZmEv06",{},[8408],{"_33":2751,"_2788":8409,"_2790":8410,"_39":8411,"_67":66},[144],[2866],{},"Daemon.PairOrigin(origin, label) — requires auth token; records consent.",{"_29":8414,"_31":8415},[],{"_33":2680,"_35":8416,"_37":1650,"_39":8417,"_63":8418,"_65":8423,"_67":66},"n5KltMDx",{},[8419],{"_33":2751,"_2788":8420,"_2790":8421,"_39":8422,"_67":66},[144,6286],[1330,2920],{},"Daemon.ListPairedOrigins / UnpairOrigin.",{"_33":2680,"_35":8425,"_37":1650,"_39":8426,"_63":8427,"_65":8433,"_67":66},"A_aQmczz",{"_2719":2972},[8428],{"_33":2751,"_2788":8429,"_2790":8430,"_39":8432,"_67":66},[6369],[8431],99,{},"Extend the allowlist from Phase 1 into a persisted, per-user config (/paired_origins.json). Editable via a new Daemon RPC:",{"_29":8435,"_31":8436},[],{"_33":2680,"_35":8437,"_37":1650,"_39":8438,"_63":8439,"_65":8440,"_67":66},"szoETaYP",{},[],"New desktop setting UI that lists paired origins and lets the user revoke.",{"_29":8442,"_31":8443},[],{"_33":2680,"_35":8444,"_37":1650,"_39":8445,"_63":8446,"_65":8453,"_67":66},"KHAs2aHb",{},[8447],{"_33":2751,"_2788":8448,"_2790":8450,"_39":8452,"_67":66},[144,8449],141,[2836,8451],155,{},"backend/daemon/http.go — CORS middleware consults the allowlist at request time; reject preflight with 403 for unknown origins. The gRPC-web WithOriginFunc consults the same list.",{"_29":8455,"_31":8456},[],{"_33":2680,"_35":8457,"_37":1650,"_39":8458,"_63":8459,"_65":8464,"_67":66},"FVFY0k7X",{},[8460],{"_33":2751,"_2788":8461,"_2790":8462,"_39":8463,"_67":66},[491],[6571],{},"Document the pairing model in docs/ (one short file).",{"_29":8466,"_31":8467},[],{"_33":2680,"_35":8468,"_37":1650,"_39":8469,"_63":8470,"_65":8471,"_67":66},"VfP7knR_",{},[],"This phase intentionally stops short of per-origin scoped tokens — it still reuses the single loopback token for transport auth but narrows which browser contexts are permitted to hold it.",{"_33":3020,"_35":8473,"_37":1650,"_39":8474,"_63":8475,"_65":8257,"_67":66},"vr_20wCy",{"_2719":2972},[],{"_29":8477,"_31":8492},[8478,8485],{"_29":8479,"_31":8480},[],{"_33":2680,"_35":8481,"_37":1650,"_39":8482,"_63":8483,"_65":8484,"_67":66},"wTW2Wk4V",{},[],"Unit tests for the allowlist store (add/remove/match including port, scheme, case).",{"_29":8486,"_31":8487},[],{"_33":2680,"_35":8488,"_37":1650,"_39":8489,"_63":8490,"_65":8491,"_67":66},"X4Gv1lBK",{},[],"Middleware test verifying unknown origin → 403 preflight and blocked actual request.",{"_33":3020,"_35":8493,"_37":1650,"_39":8494,"_63":8495,"_65":8379,"_67":66},"2ag1CnEr",{"_2719":2972},[],{"_33":3020,"_35":8497,"_37":1650,"_39":8498,"_63":8499,"_65":8500,"_67":66},"temMeFGg",{"_2719":243},[],"Phase 2 — CORS/Origin allowlist + site-specific pairing",{"_29":8502,"_31":8889},[8503,8514,8678,8746,8858],{"_29":8504,"_31":8505},[],{"_33":2680,"_35":8506,"_37":1650,"_39":8507,"_63":8508,"_65":8513,"_67":66},"YD7gy45T",{},[8509],{"_33":3084,"_2788":8510,"_2790":8511,"_39":8512,"_67":66},[144],[1057],{},"Outcome: the Remix server knows the browser's principal (public key), the site daemon authenticates the web server via a shared env token, and private documents are served only to browsers that present a capability authorizing that principal to read them.",{"_29":8515,"_31":8673},[8516,8527,8550,8636,8666],{"_29":8517,"_31":8518},[],{"_33":2680,"_35":8519,"_37":1650,"_39":8520,"_63":8521,"_65":8526,"_67":66},"afHQ0vbT",{},[8522],{"_33":2751,"_2788":8523,"_2790":8524,"_39":8525,"_67":66},[8079,6848],[7705,6370],{},"Reuse the non-extractable keypair the browser already holds (frontend/apps/web/app/auth-utils.ts:102-135, auth-session.ts). No new key material.",{"_29":8528,"_31":8540},[8529],{"_29":8530,"_31":8531},[],{"_33":2680,"_35":8532,"_37":1650,"_39":8533,"_63":8534,"_65":8539,"_67":66},"6DSYcrCX",{},[8535],{"_33":2751,"_2788":8536,"_2790":8537,"_39":8538,"_67":66},[144],[2920],{},"frontend/apps/web/app/session.server.ts (new).",{"_33":2680,"_35":8541,"_37":1650,"_39":8542,"_63":8543,"_65":8549,"_67":66},"b4OZQsek",{"_2719":2972},[8544],{"_33":2751,"_2788":8545,"_2790":8546,"_39":8548,"_67":66},[2889,2851,2893,2891],[2817,6289,8547,2840],76,{},"New Remix session backed by createCookieSessionStorage with httpOnly, secure, sameSite: 'lax', 30-day max age, secret from env:",{"_29":8551,"_31":8627},[8552,8563,8616],{"_29":8553,"_31":8554},[],{"_33":2680,"_35":8555,"_37":1650,"_39":8556,"_63":8557,"_65":8562,"_67":66},"Z7U_Ik3Q",{},[8558],{"_33":2751,"_2788":8559,"_2790":8560,"_39":8561,"_67":66},[144,2822],[2907,7521],{},"hm.auth.challenge.tsx (POST) — server returns {challenge: base64url(32 random bytes), nonce, expiresAt}. Nonce stored in an unauthenticated short-lived cookie or in the session pre-auth bucket.",{"_29":8564,"_31":8607},[8565,8576,8588,8595],{"_29":8566,"_31":8567},[],{"_33":2680,"_35":8568,"_37":1650,"_39":8569,"_63":8570,"_65":8575,"_67":66},"ZmqvwmGL",{},[8571],{"_33":2751,"_2788":8572,"_2790":8573,"_39":8574,"_67":66},[2890],[8306],{},"principal matches multikey self-consistency (reuse frontend/apps/web/app/auth-utils.ts),",{"_29":8577,"_31":8578},[],{"_33":2680,"_35":8579,"_37":1650,"_39":8580,"_63":8581,"_65":8587,"_67":66},"eKo3zpeM",{},[8582],{"_33":2751,"_2788":8583,"_2790":8585,"_39":8586,"_67":66},[2087,6568,8584],136,[2966,8080,6387],{},"signature over challenge || origin || nonce is valid (verify via crypto.subtle.verify in the Node runtime — already used for Ed25519 in auth-session.ts),",{"_29":8589,"_31":8590},[],{"_33":2680,"_35":8591,"_37":1650,"_39":8592,"_63":8593,"_65":8594,"_67":66},"nD84OWh9",{},[],"nonce fresh and unused.",{"_29":8596,"_31":8597},[],{"_33":2680,"_35":8598,"_37":1650,"_39":8599,"_63":8600,"_65":8606,"_67":66},"Q1Puw_hq",{},[8601],{"_33":2751,"_2788":8602,"_2790":8603,"_39":8605,"_67":66},[783],[8604],98,{},"On success: set session cookie containing {principal, publicKeyMultikey, issuedAt, capabilities[]}; return success.",{"_33":2680,"_35":8608,"_37":1650,"_39":8609,"_63":8610,"_65":8615,"_67":66},"V3QjVriP",{"_2719":2972},[8611],{"_33":2751,"_2788":8612,"_2790":8613,"_39":8614,"_67":66},[144,6567],[2821,6802],{},"hm.auth.login.tsx (POST) — client sends {publicKeyMultikey, signature, nonce}; server verifies:",{"_29":8617,"_31":8618},[],{"_33":2680,"_35":8619,"_37":1650,"_39":8620,"_63":8621,"_65":8626,"_67":66},"HJzqUThQ",{},[8622],{"_33":2751,"_2788":8623,"_2790":8624,"_39":8625,"_67":66},[144],[2918],{},"hm.auth.logout.tsx — destroy session.",{"_33":2680,"_35":8628,"_37":1650,"_39":8629,"_63":8630,"_65":8635,"_67":66},"sceSwNXc",{"_2719":2972},[8631],{"_33":2751,"_2788":8632,"_2790":8633,"_39":8634,"_67":66},[2821],[2822],{},"New routes under frontend/apps/web/app/routes/:",{"_29":8637,"_31":8657},[8638,8650],{"_29":8639,"_31":8640},[],{"_33":2680,"_35":8641,"_37":1650,"_39":8642,"_63":8643,"_65":8649,"_67":66},"Xl4kPMHQ",{},[8644],{"_33":2751,"_2788":8645,"_2790":8646,"_39":8648,"_67":66},[144,8201,6791],[2839,6613,8647],124,{},"loginWithLocalKey() — fetches challenge, signs via existing WebCrypto keypair, POSTs to /hm/auth/login, updates keyPairStore.",{"_29":8651,"_31":8652},[],{"_33":2680,"_35":8653,"_37":1650,"_39":8654,"_63":8655,"_65":8656,"_67":66},"zC93FAOe",{},[],"Call automatically on first mount when a local keypair exists but the session cookie is missing.",{"_33":2680,"_35":8658,"_37":1650,"_39":8659,"_63":8660,"_65":8665,"_67":66},"p0LQKqOk",{"_2719":2972},[8661],{"_33":2751,"_2788":8662,"_2790":8663,"_39":8664,"_67":66},[2821],[3088],{},"Client helper in frontend/apps/web/app/auth.tsx:",{"_29":8667,"_31":8668},[],{"_33":2680,"_35":8669,"_37":1650,"_39":8670,"_63":8671,"_65":8672,"_67":66},"Ukq3NU6s",{},[],"Remove any flows that relied on the browser telling the server its identity inline per-request — the cookie is canonical.",{"_33":3020,"_35":8674,"_37":1650,"_39":8675,"_63":8676,"_65":8677,"_67":66},"jQ_JaiEB",{"_2719":2972},[],"Browser ↔ web server (challenge-sign login, httpOnly cookie)",{"_29":8679,"_31":8741},[8680,8696,8707,8719,8730],{"_29":8681,"_31":8682},[],{"_33":2680,"_35":8683,"_37":1650,"_39":8684,"_63":8685,"_65":8695,"_67":66},"1-PDtBuB",{},[8686,8691],{"_33":2751,"_2788":8687,"_2790":8689,"_39":8690,"_67":66},[144,2878,175,2823,8688,6676],130,[2889,8079,2894,7705,340,311],{},{"_33":3084,"_2788":8692,"_2790":8693,"_39":8694,"_67":66},[6804],[7520],{},"ops/docker-compose.yml:28-72 — inject a new DAEMON_AUTH_TOKEN env var into both seed-daemon and seed-web containers, sourced from ${DAEMON_AUTH_TOKEN} at deploy time. Deployment tooling (website_deployment.sh) generates the token once per env and stores it in the deployment secret store.",{"_29":8697,"_31":8698},[],{"_33":2680,"_35":8699,"_37":1650,"_39":8700,"_63":8701,"_65":8706,"_67":66},"otXErEZ1",{},[8702],{"_33":2751,"_2788":8703,"_2790":8704,"_39":8705,"_67":66},[144,6695],[6286,2853],{},"backend/daemon/authtoken.go — if SEED_DAEMON_AUTH_TOKEN env is set, prefer it over the file-on-disk (suppresses file generation). This unifies desktop (file) and server (env) models.",{"_29":8708,"_31":8709},[],{"_33":2680,"_35":8710,"_37":1650,"_39":8711,"_63":8712,"_65":8718,"_67":66},"Ewhdzqpi",{},[8713],{"_33":2751,"_2788":8714,"_2790":8715,"_39":8717,"_67":66},[144,6572,175,7538],[6837,6612,6674,8716],195,{},"frontend/apps/web/app/client.server.ts — construct a fetch wrapper that injects Authorization: Bearer ${process.env.DAEMON_AUTH_TOKEN} before every call. Pass to createGrpcWebTransport({ fetch }).",{"_29":8720,"_31":8721},[],{"_33":2680,"_35":8722,"_37":1650,"_39":8723,"_63":8724,"_65":8729,"_67":66},"_b8ucij5",{},[8725],{"_33":2751,"_2788":8726,"_2790":8727,"_39":8728,"_67":66},[144,2822],[8222,6804],{},"frontend/apps/web/app/entry.server.tsx:24 and server-universal-client.ts:15 — same wrapper for SSR prefetch fetches.",{"_29":8731,"_31":8732},[],{"_33":2680,"_35":8733,"_37":1650,"_39":8734,"_63":8735,"_65":8740,"_67":66},"VxY051ou",{},[8736],{"_33":2751,"_2788":8737,"_2790":8738,"_39":8739,"_67":66},[144,1182,6382,6804],[2905,6695,2893,175],{},".env.vars — add DAEMON_AUTH_TOKEN placeholder for dev; ensure pnpm dev and ./dev script generate and share the token between desktop dev daemon and web dev server.",{"_33":3020,"_35":8742,"_37":1650,"_39":8743,"_63":8744,"_65":8745,"_67":66},"mKwNxQa6",{"_2719":2972},[],"Web server ↔ site daemon (shared Bearer env)",{"_29":8747,"_31":8853},[8748,8781,8798,8842],{"_29":8749,"_31":8772},[8750,8761],{"_29":8751,"_31":8752},[],{"_33":2680,"_35":8753,"_37":1650,"_39":8754,"_63":8755,"_65":8760,"_67":66},"vfzI1Nto",{},[8756],{"_33":2751,"_2788":8757,"_2790":8758,"_39":8759,"_67":66},[144],[439],{},"X-Seed-Principal: — the logged-in principal.",{"_29":8762,"_31":8763},[],{"_33":2680,"_35":8764,"_37":1650,"_39":8765,"_63":8766,"_65":8771,"_67":66},"SlJRiLzg",{},[8767],{"_33":2751,"_2788":8768,"_2790":8769,"_39":8770,"_67":66},[144],[2966],{},"X-Seed-Capabilities: — the set of signed capability blobs the user already holds for the target resource (these already live in IndexedDB via vault delegation and can be PUT to the session on login).",{"_33":2680,"_35":8773,"_37":1650,"_39":8774,"_63":8775,"_65":8780,"_67":66},"S_6kFAH-",{"_2719":2972},[8776],{"_33":2751,"_2788":8777,"_2790":8778,"_39":8779,"_67":66},[144],[6837],{},"frontend/apps/web/app/routes/api.$.tsx and the SSR client: on every call to the daemon, when a session exists, forward:",{"_29":8782,"_31":8783},[],{"_33":2680,"_35":8784,"_37":1650,"_39":8785,"_63":8786,"_65":8797,"_67":66},"1RsjkMHF",{},[8787,8793],{"_33":2751,"_2788":8788,"_2790":8790,"_39":8792,"_67":66},[144,7759,8789],172,[2836,6387,8791],209,{},{"_33":3084,"_2788":8794,"_2790":8795,"_39":8796,"_67":66},[2890],[6287],{},"backend/daemon/http.go — a second middleware (runs after Bearer check) parses these headers into request context using the existing blob.WithPublicOnly pattern — introduce blob.WithCaller(ctx, principal, caps).",{"_29":8799,"_31":8833},[8800,8811,8826],{"_29":8801,"_31":8802},[],{"_33":2680,"_35":8803,"_37":1650,"_39":8804,"_63":8805,"_65":8810,"_67":66},"3Lzdhp9K",{},[8806],{"_33":2751,"_2788":8807,"_2790":8808,"_39":8809,"_67":66},[170],[2839],{},"If caller.principal is the owner → allow.",{"_29":8812,"_31":8813},[],{"_33":2680,"_35":8814,"_37":1650,"_39":8815,"_63":8816,"_65":8825,"_67":66},"m_VkGkMo",{},[8817],{"_33":2751,"_2788":8818,"_2790":8821,"_39":8824,"_67":66},[6791,8819,8820],196,236,[7984,8822,8823],234,283,{},"Else require a valid capability blob (signed by the owner, delegating read to this principal, for this path) in caller.caps. Validate the signature chain using the same logic that already accepts CreateDocumentChangeRequest.capability (proto/documents/v3alpha/documents.proto:190-192).",{"_29":8827,"_31":8828},[],{"_33":2680,"_35":8829,"_37":1650,"_39":8830,"_63":8831,"_65":8832,"_67":66},"vcUE6BmL",{},[],"Deny otherwise.",{"_33":2680,"_35":8834,"_37":1650,"_39":8835,"_63":8836,"_65":8841,"_67":66},"KwNfwoZe",{"_2719":2972},[8837],{"_33":2751,"_2788":8838,"_2790":8839,"_39":8840,"_67":66},[144,6790],[3926,6805],{},"backend/api/documents/... — in document read RPCs, when the resource's ResourceVisibility == PRIVATE:",{"_29":8843,"_31":8844},[],{"_33":2680,"_35":8845,"_37":1650,"_39":8846,"_63":8847,"_65":8852,"_67":66},"Y2XHDuFY",{},[8848],{"_33":2751,"_2788":8849,"_2790":8850,"_39":8851,"_67":66},[1057],[8172],{},"For the PublicOnly=true gateway mode (public site with only public content), this whole code path is a no-op: private reads just stay blocked as today.",{"_33":3020,"_35":8854,"_37":1650,"_39":8855,"_63":8856,"_65":8857,"_67":66},"sA5m4myD",{"_2719":2972},[],"Per-request principal + capability forwarding for private docs",{"_29":8859,"_31":8885},[8860,8867,8874],{"_29":8861,"_31":8862},[],{"_33":2680,"_35":8863,"_37":1650,"_39":8864,"_63":8865,"_65":8866,"_67":66},"9osWmWyA",{},[],"Go: table-driven tests on the document read RPC with combinations of (public/private, owner/other, with/without capability, expired capability).",{"_29":8868,"_31":8869},[],{"_33":2680,"_35":8870,"_37":1650,"_39":8871,"_63":8872,"_65":8873,"_67":66},"VMNh2kfS",{},[],"Node/Vitest: challenge-sign login round trip using a generated Ed25519 keypair; cookie set; subsequent call succeeds.",{"_29":8875,"_31":8876},[],{"_33":2680,"_35":8877,"_37":1650,"_39":8878,"_63":8879,"_65":8884,"_67":66},"kbFIzYEw",{},[8880],{"_33":2751,"_2788":8881,"_2790":8882,"_39":8883,"_67":66},[2920],[2878],{},"Integration smoke: start dev stack via ./dev, run a scripted flow that logs in, reads a private doc, logs out, confirms 403.",{"_33":3020,"_35":8886,"_37":1650,"_39":8887,"_63":8888,"_65":8379,"_67":66},"onqKYZAC",{"_2719":2972},[],{"_33":3020,"_35":8890,"_37":1650,"_39":8891,"_63":8892,"_65":8893,"_67":66},"46ILDpBC",{"_2719":243},[],"Phase 3 — Browser identity to web, web → daemon auth, private-doc capability forwarding",{"_29":8895,"_31":8965},[8896,8903],{"_29":8897,"_31":8898},[],{"_33":6334,"_35":8899,"_37":1650,"_39":8900,"_63":8901,"_65":66,"_67":8902},"HkK8XF6Z",{"_2719":243},[],"ipfs://bafybeidapmtxfthwazvifzqgi4u2zvklew5i3k4e3dkokfn5pwldznozge",{"_29":8904,"_31":8960},[8905,8916,8927,8938,8949],{"_29":8906,"_31":8907},[],{"_33":2680,"_35":8908,"_37":1650,"_39":8909,"_63":8910,"_65":8915,"_67":66},"PtABgDtX",{},[8911],{"_33":2751,"_2788":8912,"_2790":8913,"_39":8914,"_67":66},[144],[6571],{},"frontend/apps/web/app/auth-utils.ts — multikey encode/decode, principal derivation.",{"_29":8917,"_31":8918},[],{"_33":2680,"_35":8919,"_37":1650,"_39":8920,"_63":8921,"_65":8926,"_67":66},"HWlGQS4E",{},[8922],{"_33":2751,"_2788":8923,"_2790":8924,"_39":8925,"_67":66},[144],[439],{},"frontend/apps/web/app/auth-session.ts — Ed25519 sign/verify via WebCrypto.",{"_29":8928,"_31":8929},[],{"_33":2680,"_35":8930,"_37":1650,"_39":8931,"_63":8932,"_65":8937,"_67":66},"JvPLR7pX",{},[8933],{"_33":2751,"_2788":8934,"_2790":8935,"_39":8936,"_67":66},[144],[2878],{},"proto/documents/v3alpha/access_control.proto — capability signature model (already enforced on write; Phase 3 extends to read).",{"_29":8939,"_31":8940},[],{"_33":2680,"_35":8941,"_37":1650,"_39":8942,"_63":8943,"_65":8948,"_67":66},"DDIbqKNV",{},[8944],{"_33":2751,"_2788":8945,"_2790":8946,"_39":8947,"_67":66},[144,2805],[2965,6286],{},"backend/blob WithPublicOnly context pattern.",{"_29":8950,"_31":8951},[],{"_33":2680,"_35":8952,"_37":1650,"_39":8953,"_63":8954,"_65":8959,"_67":66},"p5ja6wlo",{},[8955],{"_33":2751,"_2788":8956,"_2790":8957,"_39":8958,"_67":66},[144],[2866],{},"backend/devicelink/devicelink.go — reference for random secret generation + multibase encoding.",{"_33":2680,"_35":8961,"_37":1650,"_39":8962,"_63":8963,"_65":8964,"_67":66},"g_CZzm_q",{"_2719":2972},[],"Reused primitives (do not reinvent):",{"_33":3020,"_35":8966,"_37":1650,"_39":8967,"_63":8968,"_65":8969,"_67":66},"in2blvkw",{"_2719":243},[],"Files touched (quick map)",{"_29":8971,"_31":9133},[8972,9035,9075],{"_29":8973,"_31":9026},[8974,8985,8996,9008,9015],{"_29":8975,"_31":8976},[],{"_33":2680,"_35":8977,"_37":1650,"_39":8978,"_63":8979,"_65":8984,"_67":66},"1W148ITC",{},[8980],{"_33":2751,"_2788":8981,"_2790":8982,"_39":8983,"_67":66},[144],[2907],{},"go test ./backend/... passes.",{"_29":8986,"_31":8987},[],{"_33":2680,"_35":8988,"_37":1650,"_39":8989,"_63":8990,"_65":8995,"_67":66},"cp3H1xVK",{},[8991],{"_33":2751,"_2788":8992,"_2790":8993,"_39":8994,"_67":66},[144],[6568],{},"golangci-lint run --new-from-merge-base origin/main ./backend/... clean.",{"_29":8997,"_31":8998},[],{"_33":2680,"_35":8999,"_37":1650,"_39":9000,"_63":9001,"_65":9007,"_67":66},"iygjMeM1",{},[9002],{"_33":2751,"_2788":9003,"_2790":9004,"_39":9006,"_67":66},[783,8647,8819],[8547,8451,9005],277,{},"Manual: from a second machine on the LAN, curl http://:56001/... returns connection refused. From the same box, curl http://127.0.0.1:56001/... with no Authorization returns 401; with Authorization: Bearer $(cat ~/Library/Application\\ Support/.../daemon/auth.token) returns 200.",{"_29":9009,"_31":9010},[],{"_33":2680,"_35":9011,"_37":1650,"_39":9012,"_63":9013,"_65":9014,"_67":66},"ivXUfB7i",{},[],"Manual: open Electron dev app, all existing RPC flows still work.",{"_29":9016,"_31":9017},[],{"_33":2680,"_35":9018,"_37":1650,"_39":9019,"_63":9020,"_65":9025,"_67":66},"rzlG9NZH",{},[9021],{"_33":2751,"_2788":9022,"_2790":9023,"_39":9024,"_67":66},[2907],[175],{},"DNS-rebinding check: curl -H \"Host: evil.example.com\" http://127.0.0.1:56001/... returns 403.",{"_33":2680,"_35":9027,"_37":1650,"_39":9028,"_63":9029,"_65":9034,"_67":66},"7OHpK0bS",{"_2719":2972},[9030],{"_33":3084,"_2788":9031,"_2790":9032,"_39":9033,"_67":66},[144],[882],{},"Phase 1",{"_29":9036,"_31":9066},[9037,9048,9059],{"_29":9038,"_31":9039},[],{"_33":2680,"_35":9040,"_37":1650,"_39":9041,"_63":9042,"_65":9047,"_67":66},"TxXIUGUa",{},[9043],{"_33":2751,"_2788":9044,"_2790":9045,"_39":9046,"_67":66},[144],[2891],{},"curl -H \"Origin: https://evil.example.com\" http://127.0.0.1:56001/.../grpc-web preflight returns 403.",{"_29":9049,"_31":9050},[],{"_33":2680,"_35":9051,"_37":1650,"_39":9052,"_63":9053,"_65":9058,"_67":66},"NBeSWAhL",{},[9054],{"_33":2751,"_2788":9055,"_2790":9056,"_39":9057,"_67":66},[390],[2866],{},"Pair https://seed.hypermedia.xyz, same curl returns 200/204.",{"_29":9060,"_31":9061},[],{"_33":2680,"_35":9062,"_37":1650,"_39":9063,"_63":9064,"_65":9065,"_67":66},"19RqAes5",{},[],"UI round-trip: pair, revoke, request fails.",{"_33":2680,"_35":9067,"_37":1650,"_39":9068,"_63":9069,"_65":9074,"_67":66},"ue1kfkJC",{"_2719":2972},[9070],{"_33":3084,"_2788":9071,"_2790":9072,"_39":9073,"_67":66},[144],[882],{},"Phase 2",{"_29":9076,"_31":9124},[9077,9088,9095,9102,9113],{"_29":9078,"_31":9079},[],{"_33":2680,"_35":9080,"_37":1650,"_39":9081,"_63":9082,"_65":9087,"_67":66},"5ILngjw3",{},[9083],{"_33":2751,"_2788":9084,"_2790":9085,"_39":9086,"_67":66},[144,1182,6286,2920,2837],[912,3926,439,6287,6804],{},"pnpm typecheck, pnpm test, pnpm audit, pnpm format:write clean in frontend/.",{"_29":9089,"_31":9090},[],{"_33":2680,"_35":9091,"_37":1650,"_39":9092,"_63":9093,"_65":9094,"_67":66},"7tTq6Xgy",{},[],"Unit tests for challenge-sign login green.",{"_29":9096,"_31":9097},[],{"_33":2680,"_35":9098,"_37":1650,"_39":9099,"_63":9100,"_65":9101,"_67":66},"XjAyfH5x",{},[],"Manual: in a fresh browser profile, visit a private document URL logged out → 404/403 as today. Log in with an existing local key → same URL now renders.",{"_29":9103,"_31":9104},[],{"_33":2680,"_35":9105,"_37":1650,"_39":9106,"_63":9107,"_65":9112,"_67":66},"DwMb6XZZ",{},[9108],{"_33":2751,"_2788":9109,"_2790":9110,"_39":9111,"_67":66},[2805],[1330],{},"Manual: tail seed-daemon logs; confirm audit entry for each sign + each private read.",{"_29":9114,"_31":9115},[],{"_33":2680,"_35":9116,"_37":1650,"_39":9117,"_63":9118,"_65":9123,"_67":66},"I-uJO56S",{},[9119],{"_33":2751,"_2788":9120,"_2790":9121,"_39":9122,"_67":66},[144,2792,2851],[1835,2890,6289],{},"curl against staging with a wrong DAEMON_AUTH_TOKEN env for seed-web → web server startup fails fast; with the correct token and no session cookie, private docs still 403.",{"_33":2680,"_35":9125,"_37":1650,"_39":9126,"_63":9127,"_65":9132,"_67":66},"cw7XBTaT",{"_2719":2972},[9128],{"_33":3084,"_2788":9129,"_2790":9130,"_39":9131,"_67":66},[144],[882],{},"Phase 3",{"_33":3020,"_35":9134,"_37":1650,"_39":9135,"_63":9136,"_65":6960,"_67":66},"hmNeO9qx",{"_2719":243},[],{"_29":9138,"_31":9160},[9139,9146,9153],{"_29":9140,"_31":9141},[],{"_33":2680,"_35":9142,"_37":1650,"_39":9143,"_63":9144,"_65":9145,"_67":66},"NL8vv9j_",{},[],"Ship Phase 1 in a desktop-only release; site deployments temporarily continue without Bearer (daemon accepts env-overridden empty token in a dev-only code path).",{"_29":9147,"_31":9148},[],{"_33":2680,"_35":9149,"_37":1650,"_39":9150,"_63":9151,"_65":9152,"_67":66},"e4eSJi3f",{},[],"Ship Phase 2 once desktop Phase 1 is stable.",{"_29":9154,"_31":9155},[],{"_33":2680,"_35":9156,"_37":1650,"_39":9157,"_63":9158,"_65":9159,"_67":66},"VtGM004F",{},[],"Deploy Phase 3 together — site daemon + seed-web in the same release, with env token provisioned by deploy tooling, then flip private-doc enforcement on.",{"_33":3020,"_35":9161,"_37":1650,"_39":9162,"_63":9163,"_65":9164,"_67":66},"k5nc-srG",{"_2719":3238},[],"Rollout order",[76],"/tech-talks/daemon-security-hardening-plan",{"_84":1670},{},{"_90":1650,"_94":1668},{"_35":1647,"_102":51,"_52":9171,"_68":1650,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1649],1779255260594,[156,1647,1650,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/daemon-security-hardening-plan\",\"bafyreifxw2yvphkvtcdroxtkoqxil4flyropjicegipccrmbzmhy6a3uvm\",true]",{"_117":9176,"_154":9310,"_157":9311},{"_119":9177,"_139":42,"_140":6300,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":9178,"_35":9308},{"_26":9179,"_68":1676,"_69":51,"_70":9302,"_52":9303,"_78":1685,"_80":9304,"_82":9305,"_88":9306,"_90":1686,"_92":9307,"_96":97},[9180,9187,9215,9240,9261,9282],{"_29":9181,"_31":9182},[],{"_33":2680,"_35":9183,"_37":1686,"_39":9184,"_63":9185,"_65":9186,"_67":66},"AYtDZh3Z",{},[],"Our playbook for fixing performance issues",{"_29":9188,"_31":9210},[9189,9196,9203],{"_29":9190,"_31":9191},[],{"_33":2680,"_35":9192,"_37":1686,"_39":9193,"_63":9194,"_65":9195,"_67":66},"y9Zhvzqf",{},[],"What is the user experiencing, in reality",{"_29":9197,"_31":9198},[],{"_33":2680,"_35":9199,"_37":1686,"_39":9200,"_63":9201,"_65":9202,"_67":66},"0bJ3lq1J",{},[],"Some of our active user pains regarding performance:",{"_29":9204,"_31":9205},[],{"_33":2727,"_35":9206,"_37":1676,"_39":9207,"_63":9208,"_65":66,"_67":9209},"gF9j1Rzz",{"_2730":44},[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/performance/pains",{"_33":3020,"_35":9211,"_37":1686,"_39":9212,"_63":9213,"_65":9214,"_67":66},"jXL3cyKd",{"_2719":243},[],"Define User Pain",{"_29":9216,"_31":9235},[9217,9228],{"_29":9218,"_31":9219},[],{"_33":2680,"_35":9220,"_37":1676,"_39":9221,"_63":9222,"_65":9227,"_67":66},"6E-E9dqO",{},[9223],{"_33":3084,"_2788":9224,"_2790":9225,"_39":9226,"_67":66},[2839],[3088],{},"Check the p90 that corresponds to the user pain- track the 90% worst case scenario for performance",{"_29":9229,"_31":9230},[],{"_33":2727,"_35":9231,"_37":1676,"_39":9232,"_63":9233,"_65":66,"_67":9234},"JjssSywa",{"_2730":44},[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/performance/measurement",{"_33":3020,"_35":9236,"_37":1686,"_39":9237,"_63":9238,"_65":9239,"_67":66},"NWfK-uef",{"_2719":243},[],"Measure",{"_29":9241,"_31":9256},[9242,9249],{"_29":9243,"_31":9244},[],{"_33":2680,"_35":9245,"_37":1686,"_39":9246,"_63":9247,"_65":9248,"_67":66},"Qp9CdroL",{},[],"Use more measurement systems to see if we are constrained by CPU/Memory/Disk/Network/Contention",{"_29":9250,"_31":9251},[],{"_33":2680,"_35":9252,"_37":1676,"_39":9253,"_63":9254,"_65":9255,"_67":66},"9VvbGXJH",{},[],"This will often require additional measurement, custom code that drills into the specific area.",{"_33":3020,"_35":9257,"_37":1686,"_39":9258,"_63":9259,"_65":9260,"_67":66},"3MgXSh34",{"_2719":243},[],"Identify Bottleneck",{"_29":9262,"_31":9277},[9263,9270],{"_29":9264,"_31":9265},[],{"_33":2680,"_35":9266,"_37":1686,"_39":9267,"_63":9268,"_65":9269,"_67":66},"fBwx_qDT",{},[],"The solution depends on the bottleneck, but the short answer is to remove work during the hot path. Use fewer of the constrained resource.",{"_29":9271,"_31":9272},[],{"_33":2680,"_35":9273,"_37":1686,"_39":9274,"_63":9275,"_65":9276,"_67":66},"E9hhwt7N",{},[],"Cache, batch, eliminate redundancy, precompute.",{"_33":3020,"_35":9278,"_37":1686,"_39":9279,"_63":9280,"_65":9281,"_67":66},"7E62BZHN",{"_2719":243},[],"Solve",{"_29":9283,"_31":9298},[9284,9291],{"_29":9285,"_31":9286},[],{"_33":2680,"_35":9287,"_37":1686,"_39":9288,"_63":9289,"_65":9290,"_67":66},"0RA_E5U8",{},[],"The solution must be verified with measurements.",{"_29":9292,"_31":9293},[],{"_33":2680,"_35":9294,"_37":1686,"_39":9295,"_63":9296,"_65":9297,"_67":66},"vmIUy8ze",{},[],"To prevent perf regressions, we should continue measuring.",{"_33":3020,"_35":9299,"_37":1686,"_39":9300,"_63":9301,"_65":9239,"_67":66},"cXaaz74x",{"_2719":243},[],[72],"/tech-talks/performance","2026-04-16T10:29:24.660Z",{"_84":1699},{},{"_90":1686,"_94":1697},{"_35":1673,"_102":51,"_52":9309,"_68":1676,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1675],[156,1673,1676,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/performance\",\"bafy2bzacedi4bpq3yn2vzvfzjlfcvf2mchbaaxaefnxrrxuh3yarnz5qfjsnc\",true]",{"_117":9313,"_154":9583,"_157":9584},{"_119":9314,"_139":42,"_140":9582,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":9315,"_35":9580},{"_26":9316,"_68":1992,"_69":51,"_70":9575,"_52":9576,"_78":1998,"_80":1998,"_82":9577,"_88":9578,"_90":1992,"_92":9579,"_96":97},[9317,9324,9374,9477,9491],{"_29":9318,"_31":9319},[],{"_33":2680,"_35":9320,"_37":1992,"_39":9321,"_63":9322,"_65":9323,"_67":66},"OySJY-8e",{},[],"A work-in-progress proposal for schema features in the Hypermedia protocol",{"_29":9325,"_31":9369},[9326,9333],{"_29":9327,"_31":9328},[],{"_33":2680,"_35":9329,"_37":1992,"_39":9330,"_63":9331,"_65":9332,"_67":66},"Bp0CsaBj",{},[],"Onyx is highly pragmatic- we are not introducing formality for the sake of it.",{"_29":9334,"_31":9364},[9335,9343,9350,9357],{"_29":9336,"_31":9337},[],{"_33":2727,"_35":9338,"_37":1992,"_39":9339,"_63":9341,"_65":66,"_67":9342},"M3ka1CKX",{"_2730":9340},"Content",[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas?v=bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg#HmME35mT",{"_29":9344,"_31":9345},[],{"_33":2727,"_35":9346,"_37":1992,"_39":9347,"_63":9348,"_65":66,"_67":9349},"u18K0O7l",{"_2730":9340},[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas?v=bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg#FJHuB6we",{"_29":9351,"_31":9352},[],{"_33":2727,"_35":9353,"_37":1992,"_39":9354,"_63":9355,"_65":66,"_67":9356},"cgXGlFa1",{"_2730":9340},[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas?v=bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg#LKr8ygxd",{"_29":9358,"_31":9359},[],{"_33":2727,"_35":9360,"_37":1992,"_39":9361,"_63":9362,"_65":66,"_67":9363},"rWRXjxE-",{"_2730":9340},[],"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas?v=bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg#_-Srxyx_",{"_33":2680,"_35":9365,"_37":1992,"_39":9366,"_63":9367,"_65":9368,"_67":66},"wDn9NrB_",{"_2719":243},[],"We aim to solve the following problems:",{"_33":3020,"_35":9370,"_37":1992,"_39":9371,"_63":9372,"_65":9373,"_67":66},"wXmALapg",{"_2719":243},[],"Problem",{"_29":9375,"_31":9472},[9376,9394,9405,9430,9437,9451],{"_29":9377,"_31":9378},[],{"_33":2680,"_35":9379,"_37":1992,"_39":9380,"_63":9381,"_65":9393,"_67":66},"FYUdVdUT",{},[9382,9388],{"_33":204,"_2788":9383,"_2790":9384,"_39":9386,"_67":9387},[2793],[9385],108,{},"https://www.dataversity.net/articles/introduction-to-open-world-assumption-vs-closed-world-assumption/",{"_33":204,"_2788":9389,"_2790":9390,"_39":9391,"_67":9392},[8647],[8819],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas?v=bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg#ZexSDrvQ","Before we implement schemas, we must decide how to balance Open World Assumption and Closed World Assumption. Also, we must support existing data in the HM network which does not yet have a schema. The other goal is to keep the barrier low for new implementers of software on the network.",{"_29":9395,"_31":9396},[],{"_33":2680,"_35":9397,"_37":1992,"_39":9398,"_63":9399,"_65":9404,"_67":66},"fWQtvYHL",{},[9400],{"_33":3084,"_2788":9401,"_2790":9402,"_39":9403,"_67":66},[7703,2549],[2853,6401],{},"So, schemas are optional. HM is \"Open World\" by default. We include fallback schemas for existing types in HM25. A schema provides utility but is not meant to break software. At the most extreme, software will warn users when content does not conform to the stated schema.",{"_29":9406,"_31":9421},[9407,9414],{"_29":9408,"_31":9409},[],{"_33":2680,"_35":9410,"_37":1992,"_39":9411,"_63":9412,"_65":9413,"_67":66},"CHqmi0rK",{},[],"Be parsable. We are using DAG-CBOR encoded IPFS blobs. If this parsing fails, the data is considered garbage. Otherwise, we can present it to the user in some capacity.",{"_29":9415,"_31":9416},[],{"_33":2680,"_35":9417,"_37":1992,"_39":9418,"_63":9419,"_65":9420,"_67":66},"VvHRG-BS",{},[],"Have correct signature, trust, capabilities - All software in the HM ecosystem must build upon our trust primitives to ensure that data is owned and controlled by the correct keys. This is a prerequisite of Onyx Hypermedia",{"_33":2680,"_35":9422,"_37":1992,"_39":9423,"_63":9424,"_65":9429,"_67":66},"hG-xGhQr",{"_2719":3238},[9425],{"_33":3084,"_2788":9426,"_2790":9427,"_39":9428,"_67":66},[8547],[175],{},"What are the hard requirements for data in the HM ecosystem? All HM content must:",{"_29":9431,"_31":9432},[],{"_33":2680,"_35":9433,"_37":1992,"_39":9434,"_63":9435,"_65":9436,"_67":66},"zv1Kexmj",{},[],"Note: it is important for users to see what data exists inside the content they are referencing and signing. If the software encounters unknown fields in the data, they must be presented to the user in the best way possible. This will prevent users from accidentally referencing and signing \"invisible\" content which may be undesirable or weighty. Unexpected data that shows up in any blob (Profiles, Changes, Refs, Doc Change Blocks) must be surfaced to the user.",{"_29":9438,"_31":9446},[9439],{"_29":9440,"_31":9441},[],{"_33":2680,"_35":9442,"_37":1992,"_39":9443,"_63":9444,"_65":9445,"_67":66},"ZaBvLpcg",{},[],"Still undecided. See below \"Schema Decision-Making\"",{"_33":3020,"_35":9447,"_37":1992,"_39":9448,"_63":9449,"_65":9450,"_67":66},"t0myJCCR",{"_2719":243},[],"Schema Definitions",{"_29":9452,"_31":9467},[9453,9460],{"_29":9454,"_31":9455},[],{"_33":2680,"_35":9456,"_37":1992,"_39":9457,"_63":9458,"_65":9459,"_67":66},"1UQaGJ-C",{},[],"To handle existing content, we will resolve to our own published schemas depending on the \"type\" field that is defined.",{"_29":9461,"_31":9462},[],{"_33":2680,"_35":9463,"_37":1992,"_39":9464,"_63":9465,"_65":9466,"_67":66},"iavDxiij",{},[],"New content signed by respectful software will include the appropriate schema metadata.",{"_33":3020,"_35":9468,"_37":1992,"_39":9469,"_63":9470,"_65":9471,"_67":66},"Xs-LSvr_",{"_2719":243},[],"Fallback Schemas",{"_33":3020,"_35":9473,"_37":1992,"_39":9474,"_63":9475,"_65":9476,"_67":66},"IQx3W8Xe",{"_2719":243},[],"Solution",{"_29":9478,"_31":9486},[9479],{"_29":9480,"_31":9481},[],{"_33":2680,"_35":9482,"_37":1992,"_39":9483,"_63":9484,"_65":9485,"_67":66},"kCFSPKa6",{},[],"A work in progress",{"_33":3020,"_35":9487,"_37":1992,"_39":9488,"_63":9489,"_65":9490,"_67":66},"AqXN-G0o",{"_2719":243},[],"Schema Decision-Making",{"_29":9492,"_31":9570},[9493],{"_29":9494,"_31":9565},[9495,9530,9537,9544,9551,9558],{"_29":9496,"_31":9525},[9497,9504,9511,9518],{"_29":9498,"_31":9499},[],{"_33":2680,"_35":9500,"_37":1992,"_39":9501,"_63":9502,"_65":9503,"_67":66},"AJXz9JVE",{},[],"RDFS",{"_29":9505,"_31":9506},[],{"_33":2680,"_35":9507,"_37":1992,"_39":9508,"_63":9509,"_65":9510,"_67":66},"9MnAL1cg",{},[],"OWL",{"_29":9512,"_31":9513},[],{"_33":2680,"_35":9514,"_37":1992,"_39":9515,"_63":9516,"_65":9517,"_67":66},"-tU-WH9q",{},[],"SHACL + DASH",{"_29":9519,"_31":9520},[],{"_33":2680,"_35":9521,"_37":1992,"_39":9522,"_63":9523,"_65":9524,"_67":66},"G1-UN3-5",{},[],"SKOS",{"_33":2680,"_35":9526,"_37":1992,"_39":9527,"_63":9528,"_65":9529,"_67":66},"KQQ974pA",{"_2719":2972},[],"RDF",{"_29":9531,"_31":9532},[],{"_33":2680,"_35":9533,"_37":1992,"_39":9534,"_63":9535,"_65":9536,"_67":66},"siRzbT_Z",{},[],"XRPC",{"_29":9538,"_31":9539},[],{"_33":2680,"_35":9540,"_37":1992,"_39":9541,"_63":9542,"_65":9543,"_67":66},"puKw4h9F",{},[],"graphQL",{"_29":9545,"_31":9546},[],{"_33":2680,"_35":9547,"_37":1992,"_39":9548,"_63":9549,"_65":9550,"_67":66},"Ay3lZvox",{},[],"IPLD schemas",{"_29":9552,"_31":9553},[],{"_33":2680,"_35":9554,"_37":1992,"_39":9555,"_63":9556,"_65":9557,"_67":66},"DY4p6LW3",{},[],"XSL (XML Schemas)",{"_29":9559,"_31":9560},[],{"_33":2680,"_35":9561,"_37":1992,"_39":9562,"_63":9563,"_65":9564,"_67":66},"fqp5XjXE",{},[],"FHIR",{"_33":2680,"_35":9566,"_37":1992,"_39":9567,"_63":9568,"_65":9569,"_67":66},"yPozpIig",{"_2719":2972},[],"Assorted technology we considered, much that helped inspire/influence this proposal",{"_33":3020,"_35":9571,"_37":1992,"_39":9572,"_63":9573,"_65":9574,"_67":66},"rabvbsu5",{"_2719":243},[],"Inspirations and References",[72],"/tech-talks/hypermedia-onyx",{"_84":2011},{},{"_90":1992,"_94":2009},{"_35":1989,"_102":51,"_52":9581,"_68":1992,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1991],1779255260522,[156,1989,1992,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-onyx\",\"bafy2bzaceb7tz2sp2djraj3gqhmlizfx7pfboksywc2v6ayvw7scmcr2t5qfc\",true]",{"_117":9586,"_154":9855,"_157":9856},{"_119":9587,"_139":42,"_140":9854,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":9588,"_35":9852},{"_26":9589,"_68":1816,"_69":51,"_70":9846,"_52":9847,"_78":1825,"_80":9848,"_82":9849,"_88":9850,"_90":1826,"_92":9851,"_96":97},[9590,9603,9610,9768],{"_29":9591,"_31":9592},[],{"_33":2680,"_35":9593,"_37":9594,"_39":9595,"_63":9596,"_65":9602,"_67":66},"DtkWlOH2","bafy2bzacedet3vxbpcjqh6ocz46lou6p3dw6z7iwo7cnnczzblkw4ez2r7gmm",{},[9597],{"_33":204,"_2788":9598,"_2790":9599,"_39":9600,"_67":9601},[1057],[6365],{},"https://xanadu.com.au/general/faq.html#2","Source: https://xanadu.com.au/general/faq.html#2",{"_29":9604,"_31":9605},[],{"_33":2727,"_35":9606,"_37":1816,"_39":9607,"_63":9608,"_65":66,"_67":9609},"9kM-HXXo",{"_2730":9340},[],"hm://z6Mko5npVz4Bx9Rf4vkRUf2swvb568SDbhLwStaha3HzgrLS/community/xanadu?l",{"_29":9611,"_31":9763},[9612,9619,9626,9633,9650,9657,9669,9676,9683,9695,9702,9714,9721,9728,9735,9742,9749],{"_29":9613,"_31":9614},[],{"_33":2680,"_35":9615,"_37":1826,"_39":9616,"_63":9617,"_65":9618,"_67":66},"Ipl3lxMH",{},[],"Every Xanadu server is uniquely and securely identified.",{"_29":9620,"_31":9621},[],{"_33":2680,"_35":9622,"_37":1826,"_39":9623,"_63":9624,"_65":9625,"_67":66},"UJEiWmLt",{},[],"Every Xanadu server can be operated independently or in a network.",{"_29":9627,"_31":9628},[],{"_33":2680,"_35":9629,"_37":1826,"_39":9630,"_63":9631,"_65":9632,"_67":66},"FSt7Xt9H",{},[],"Every user is uniquely and securely identified.",{"_29":9634,"_31":9635},[],{"_33":2680,"_35":9636,"_37":1826,"_39":9637,"_63":9638,"_65":9649,"_67":66},"zEHchzaF",{},[9639,9644],{"_33":204,"_2788":9640,"_2790":9641,"_39":9642,"_67":9643},[8172],[2806],{},"https://en.wikipedia.org/wiki/Document_retrieval",{"_33":204,"_2788":9645,"_2790":9646,"_39":9647,"_67":9648},[754],[2552],{},"https://en.wikipedia.org/wiki/Computer_data_storage","Every user can search, retrieve, create, and store documents.",{"_29":9651,"_31":9652},[],{"_33":2680,"_35":9653,"_37":1826,"_39":9654,"_63":9655,"_65":9656,"_67":66},"silrkWbo",{},[],"Every document can consist of any number of parts each of which may be of any data type.",{"_29":9658,"_31":9659},[],{"_33":2680,"_35":9660,"_37":1826,"_39":9661,"_63":9662,"_65":9668,"_67":66},"Xa7o-6h0",{},[9663],{"_33":204,"_2788":9664,"_2790":9665,"_39":9666,"_67":9667},[6790],[8306],{},"https://en.wikipedia.org/wiki/Transclusion","Every document can contain links of any type including virtual copies (\"transclusions\") to any other document in the system accessible to its owner.",{"_29":9670,"_31":9671},[],{"_33":2680,"_35":9672,"_37":1826,"_39":9673,"_63":9674,"_65":9675,"_67":66},"SNk8iy-n",{},[],"Links are visible and can be followed from all endpoints.",{"_29":9677,"_31":9678},[],{"_33":2680,"_35":9679,"_37":1826,"_39":9680,"_63":9681,"_65":9682,"_67":66},"4EZVR9aY",{},[],"Permission to link to a document is explicitly granted by the act of publication.",{"_29":9684,"_31":9685},[],{"_33":2680,"_35":9686,"_37":1826,"_39":9687,"_63":9688,"_65":9694,"_67":66},"fmuHSKRa",{},[9689],{"_33":204,"_2788":9690,"_2790":9691,"_39":9693,"_67":9667},[6675],[9692],168,{},"Every document can contain a royalty mechanism at any desired degree of granularity to ensure payment on any portion accessed, including virtual copies (\"transclusions\") of all or part of the document.",{"_29":9696,"_31":9697},[],{"_33":2680,"_35":9698,"_37":1826,"_39":9699,"_63":9700,"_65":9701,"_67":66},"JyGVZSE0",{},[],"Every document is uniquely and securely identified.",{"_29":9703,"_31":9704},[],{"_33":2680,"_35":9705,"_37":1826,"_39":9706,"_63":9707,"_65":9713,"_67":66},"40OrA4zH",{},[9708],{"_33":204,"_2788":9709,"_2790":9710,"_39":9711,"_67":9712},[2806],[2822],{},"https://en.wikipedia.org/wiki/Access_control","Every document can have secure access controls.",{"_29":9715,"_31":9716},[],{"_33":2680,"_35":9717,"_37":1826,"_39":9718,"_63":9719,"_65":9720,"_67":66},"58jJENEY",{},[],"Every document can be rapidly searched, stored and retrieved without user knowledge of where it is physically stored.",{"_29":9722,"_31":9723},[],{"_33":2680,"_35":9724,"_37":1826,"_39":9725,"_63":9726,"_65":9727,"_67":66},"zymiGzgi",{},[],"Every document is automatically moved to physical storage appropriate to its frequency of access from any given location.",{"_29":9729,"_31":9730},[],{"_33":2680,"_35":9731,"_37":1826,"_39":9732,"_63":9733,"_65":9734,"_67":66},"wq0juetm",{},[],"Every document is automatically stored redundantly to maintain availability even in case of a disaster.",{"_29":9736,"_31":9737},[],{"_33":2680,"_35":9738,"_37":1826,"_39":9739,"_63":9740,"_65":9741,"_67":66},"JkqR9Bjp",{},[],"Every Xanadu service provider can charge their users at any rate they choose for the storage, retrieval, and publishing of documents.",{"_29":9743,"_31":9744},[],{"_33":2680,"_35":9745,"_37":1826,"_39":9746,"_63":9747,"_65":9748,"_67":66},"ffTaMel4",{},[],"Every transaction is secure and auditable only by the parties to that transaction.",{"_29":9750,"_31":9751},[],{"_33":2680,"_35":9752,"_37":1826,"_39":9753,"_63":9754,"_65":9762,"_67":66},"VD1kpfmr",{},[9755],{"_33":204,"_2788":9756,"_2790":9758,"_39":9760,"_67":9761},[9757],144,[9759],148,{},"https://en.wikipedia.org/wiki/Project_Xanadu#cite_note-13","The Xanadu client–server communication protocol is an openly published standard. Third-party software development and integration is encouraged.[13]",{"_33":2680,"_35":9764,"_37":1826,"_39":9765,"_63":9766,"_65":9767,"_67":66},"z68c_qL9",{"_2719":3238},[],"Sharing what others dreamt before us as inspiration:",{"_29":9769,"_31":9841},[9770,9825],{"_29":9771,"_31":9772},[],{"_33":2680,"_35":9773,"_37":9774,"_39":9775,"_63":9776,"_65":9824,"_67":66},"Bn8hWa9Q","bafy2bzaceaabqdj56z33t7tihid574cbrliecul6zmpijgn4sujnwnwd7taw2",{},[9777,9781,9787,9793,9798,9804,9811,9818],{"_33":3084,"_2788":9778,"_2790":9779,"_39":9780,"_67":66},[3088],[2817],{},{"_33":204,"_2788":9782,"_2790":9783,"_39":9785,"_67":9786},[2825],[9784],152,{},"https://en.wikipedia.org/wiki/Gary_Wolf_(journalist)",{"_33":9788,"_2788":9789,"_2790":9790,"_39":9792,"_67":66},"Italic",[7537],[9791],161,{},{"_33":204,"_2788":9794,"_2790":9795,"_39":9796,"_67":9797},[7537],[9791],{},"https://en.wikipedia.org/wiki/Wired_(magazine)",{"_33":204,"_2788":9799,"_2790":9801,"_39":9802,"_67":9803},[9800],438,[8025],{},"https://en.wikipedia.org/wiki/Roger_Gregory_(programmer)",{"_33":204,"_2788":9805,"_2790":9807,"_39":9809,"_67":9810},[9806],456,[9808],467,{},"https://en.wikipedia.org/wiki/Mark_S._Miller",{"_33":204,"_2788":9812,"_2790":9814,"_39":9816,"_67":9817},[9813],468,[9815],471,{},"https://en.wikipedia.org/wiki/Project_Xanadu#cite_note-WiredCurse-3",{"_33":204,"_2788":9819,"_2790":9820,"_39":9822,"_67":9823},[9815],[9821],475,{},"https://en.wikipedia.org/wiki/Project_Xanadu#cite_note-nelsonACM-14","In the design of the Xanadu computer system, a tumbler is an address of any range of content or link or a set of ranges or links. According to Gary Wolf in Wired, the idea of tumblers was that \"the address would not only point the reader to the correct machine, it would also indicate the author of the document, the version of the document, the correct span of bytes, and the links associated with these bytes.\" Tumblers were created by Roger Gregory and Mark Miller.[3][14]",{"_29":9826,"_31":9827},[],{"_33":2680,"_35":9828,"_37":9774,"_39":9829,"_63":9830,"_65":9840,"_67":66},"-NcswPop",{},[9831,9836],{"_33":204,"_2788":9832,"_2790":9833,"_39":9834,"_67":9835},[3243],[2853],{},"https://en.wikipedia.org/wiki/Transfinite_number",{"_33":204,"_2788":9837,"_2790":9838,"_39":9839,"_67":9817},[6287],[2793],{},"The idea behind tumblers comes from transfinite numbers.[3]",{"_33":3020,"_35":9842,"_37":9774,"_39":9843,"_63":9844,"_65":9845,"_67":66},"Q7D02Nro",{"_2719":243},[],"Tumbler",[75],"/tech-talks/xanadu-original-17-rules","2026-03-07T10:12:05.343Z",{"_84":1840},{},{"_90":1826,"_94":1838},{"_35":1813,"_102":51,"_52":9853,"_68":1816,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1815],1779255260509,[156,1813,1816,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/xanadu-original-17-rules\",\"bafy2bzaceabnhfxttdmb25ang64fgyxwojmzqvehwhiiabdaadxc5pxcvj7a6\",true]",{"_117":9858,"_154":10253,"_157":10254},{"_119":9859,"_139":42,"_140":2765,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":9860,"_35":10251},{"_26":9861,"_68":1705,"_69":51,"_70":10245,"_52":10246,"_78":185,"_80":10247,"_82":10248,"_88":10249,"_90":1579,"_92":10250,"_96":97},[9862,9869,9989,10097,10177,10222],{"_29":9863,"_31":9864},[],{"_33":2680,"_35":9865,"_37":1705,"_39":9866,"_63":9867,"_65":9868,"_67":66},"RiR0joIG",{},[],"Seed Hypermedia provides agent skills that let AI assistants create, read, update, and search documents on the Seed protocol. This guide covers two installation methods, each with different trade-offs.",{"_29":9870,"_31":9984},[9871,9878,9886,9893,9901,9912,9920,9927,9935,9946],{"_29":9872,"_31":9873},[],{"_33":2680,"_35":9874,"_37":1705,"_39":9875,"_63":9876,"_65":9877,"_67":66},"LUkZcQ00",{},[],"The universal installer works with any AI agent that supports skills -- Claude Code, Cursor, Cline, Codex, and more. Run the following command in your terminal:",{"_29":9879,"_31":9880},[],{"_33":2751,"_35":9881,"_37":1705,"_39":9882,"_63":9884,"_65":9885,"_67":66},"snC6qasu",{"_2753":9883},"bash",[],"npx skills add seed-hypermedia/skills",{"_29":9887,"_31":9888},[],{"_33":2680,"_35":9889,"_37":1705,"_39":9890,"_63":9891,"_65":9892,"_67":66},"4GYbeRWS",{},[],"The installer clones the skill repository and presents the available skills for selection:",{"_29":9894,"_31":9895},[],{"_33":6334,"_35":9896,"_37":1705,"_39":9897,"_63":9898,"_65":9899,"_67":9900},"w1csACmo",{},[],"Skills installer showing available seed skills","ipfs://bafkreigy3ym77w2ebssrwvnmbiz5dybjghodldstnevhrgfx74jb4ehzk4",{"_29":9902,"_31":9903},[],{"_33":2680,"_35":9904,"_37":1705,"_39":9905,"_63":9906,"_65":9911,"_67":66},"vlxzQChq",{},[9907],{"_33":3084,"_2788":9908,"_2790":9909,"_39":9910,"_67":66},[882],[2087],{},"Select seed-cli (recommended starting point) and any other skills you need using the space bar:",{"_29":9913,"_31":9914},[],{"_33":6334,"_35":9915,"_37":1705,"_39":9916,"_63":9917,"_65":9918,"_67":9919},"Ku-2dDu_",{},[],"Selecting seed-cli skill for installation","ipfs://bafkreibnsatihk5xz5uyxpjm66suerudsnlogvyeur6zm2k42t7wbvy2om",{"_29":9921,"_31":9922},[],{"_33":2680,"_35":9923,"_37":1705,"_39":9924,"_63":9925,"_65":9926,"_67":66},"6adTo6WO",{},[],"The installer shows a summary with security risk assessments, the installation path, and which agents the skill will be available to:",{"_29":9928,"_31":9929},[],{"_33":6334,"_35":9930,"_37":1705,"_39":9931,"_63":9932,"_65":9933,"_67":9934},"sAfoltT-",{},[],"Installation summary with security assessments","ipfs://bafkreielnehnude43nqctowrjrqn3zu4f6kczui4fe7vg7ogzaip5hfwmi",{"_29":9936,"_31":9937},[],{"_33":2680,"_35":9938,"_37":1705,"_39":9939,"_63":9940,"_65":9945,"_67":66},"PsYmcXbn",{},[9941],{"_33":2751,"_2788":9942,"_2790":9943,"_39":9944,"_67":66},[6549],[6366],{},"Confirm the installation. The skill is now available in your agent. In Claude Code, you can invoke it with /seed-cli.",{"_29":9947,"_31":9979},[9948],{"_29":9949,"_31":9975},[9950,9957,9964],{"_29":9951,"_31":9952},[],{"_33":2680,"_35":9953,"_37":1705,"_39":9954,"_63":9955,"_65":9956,"_67":66},"nwSXiL1k",{},[],"Works with 40+ AI agents (Claude Code, Cursor, Cline, Codex, and more)",{"_29":9958,"_31":9959},[],{"_33":2680,"_35":9960,"_37":1705,"_39":9961,"_63":9962,"_65":9963,"_67":66},"HISF0LPl",{},[],"Installed locally as a symlink -- you control when to update",{"_29":9965,"_31":9966},[],{"_33":2680,"_35":9967,"_37":1705,"_39":9968,"_63":9969,"_65":9974,"_67":66},"CNxZJDSw",{},[9970],{"_33":2751,"_2788":9971,"_2790":9972,"_39":9973,"_67":66},[6287],[2840],{},"No automatic updates: to get the latest version, re-run npx skills add seed-hypermedia/skills",{"_33":2680,"_35":9976,"_37":1705,"_39":9977,"_63":9978,"_65":66,"_67":66},"iW-pRmaV",{"_2719":2972},[],{"_33":3020,"_35":9980,"_37":1705,"_39":9981,"_63":9982,"_65":9983,"_67":66},"lrMODXzH",{"_2719":243},[],"Trade-offs",{"_33":3020,"_35":9985,"_37":1705,"_39":9986,"_63":9987,"_65":9988,"_67":66},"sn1KtjLj",{"_2719":243},[],"Method 1: Universal Installer (npx skills)",{"_29":9990,"_31":10092},[9991,9998,10017,10025,10036,10044,10059],{"_29":9992,"_31":9993},[],{"_33":2680,"_35":9994,"_37":1705,"_39":9995,"_63":9996,"_65":9997,"_67":66},"krGsR4pX",{},[],"If you use Claude Code exclusively, you can install skills through the built-in marketplace. This method provides automatic daily updates.",{"_29":9999,"_31":10000},[],{"_33":2680,"_35":10001,"_37":1705,"_39":10002,"_63":10003,"_65":10016,"_67":66},"hYVLzmwL",{},[10004,10008,10012],{"_33":2751,"_2788":10005,"_2790":10006,"_39":10007,"_67":66},[2878],[2890],{},{"_33":3084,"_2788":10009,"_2790":10010,"_39":10011,"_67":66},[6369],[6400],{},{"_33":3084,"_2788":10013,"_2790":10014,"_39":10015,"_67":66},[8604],[2824],{},"Open the plugin manager in Claude Code with /plugin, navigate to the Marketplaces tab, and select + Add Marketplace:",{"_29":10018,"_31":10019},[],{"_33":6334,"_35":10020,"_37":1705,"_39":10021,"_63":10022,"_65":10023,"_67":10024},"LxazLgt3",{},[],"Claude Code marketplace tab","ipfs://bafkreigtllvm654m2phum5rgdq62nkpd6j5yovfo4ivpujx53avouezzby",{"_29":10026,"_31":10027},[],{"_33":2680,"_35":10028,"_37":1705,"_39":10029,"_63":10030,"_65":10035,"_67":66},"nuIOnue7",{},[10031],{"_33":2751,"_2788":10032,"_2790":10033,"_39":10034,"_67":66},[4245],[2890],{},"Enter the marketplace source seed-hypermedia/skills:",{"_29":10037,"_31":10038},[],{"_33":6334,"_35":10039,"_37":1705,"_39":10040,"_63":10041,"_65":10042,"_67":10043},"NDPWxOhO",{},[],"Adding the seed-hypermedia marketplace","ipfs://bafkreigm7ikzxt2rdjkwqvopnf3lxp4l6wzt7etajjlb2mzih4opfiurye",{"_29":10045,"_31":10046},[],{"_33":2680,"_35":10047,"_37":1705,"_39":10048,"_63":10049,"_65":10058,"_67":66},"QU1HFUUn",{},[10050,10054],{"_33":2751,"_2788":10051,"_2790":10052,"_39":10053,"_67":66},[4245],[6573],{},{"_33":2751,"_2788":10055,"_2790":10056,"_39":10057,"_67":66},[6805],[2824],{},"Then install the plugin with /plugin install seed-hypermedia@seed-hypermedia-skills and reload with /reload-plugins.",{"_29":10060,"_31":10088},[10061],{"_29":10062,"_31":10084},[10063,10070,10077],{"_29":10064,"_31":10065},[],{"_33":2680,"_35":10066,"_37":1705,"_39":10067,"_63":10068,"_65":10069,"_67":66},"rS_4Q37l",{},[],"Claude Code only -- does not work with other agents",{"_29":10071,"_31":10072},[],{"_33":2680,"_35":10073,"_37":1705,"_39":10074,"_63":10075,"_65":10076,"_67":66},"jdfxbJTH",{},[],"Automatic daily updates: skill improvements are picked up without manual action",{"_29":10078,"_31":10079},[],{"_33":2680,"_35":10080,"_37":1705,"_39":10081,"_63":10082,"_65":10083,"_67":66},"RAB_ZC4k",{},[],"Managed through the Claude Code plugin system",{"_33":2680,"_35":10085,"_37":1705,"_39":10086,"_63":10087,"_65":66,"_67":66},"Djd3MnDj",{"_2719":2972},[],{"_33":3020,"_35":10089,"_37":1705,"_39":10090,"_63":10091,"_65":9983,"_67":66},"OxcMAEHU",{"_2719":243},[],{"_33":3020,"_35":10093,"_37":1705,"_39":10094,"_63":10095,"_65":10096,"_67":66},"4JNtROiF",{"_2719":243},[],"Method 2: Claude Code Marketplace",{"_29":10098,"_31":10172},[10099,10111,10119,10126,10165],{"_29":10100,"_31":10101},[],{"_33":2680,"_35":10102,"_37":1705,"_39":10103,"_63":10104,"_65":10110,"_67":66},"jxWoWcP8",{},[10105],{"_33":2751,"_2788":10106,"_2790":10107,"_39":10109,"_67":66},[6612],[10108],63,{},"Once installed, the skills appear as slash commands. Type /seed to see all available Seed skills:",{"_29":10112,"_31":10113},[],{"_33":6334,"_35":10114,"_37":1705,"_39":10115,"_63":10116,"_65":10117,"_67":10118},"fPhc0GVT",{},[],"Available seed skills in Claude Code","ipfs://bafkreihwwyvw3ehc3jn6rqeuzc2idhqcdn7v6iivbjoxuqemh2zpnq3mha",{"_29":10120,"_31":10121},[],{"_33":2680,"_35":10122,"_37":1705,"_39":10123,"_63":10124,"_65":10125,"_67":66},"9rHjXVZ8",{},[],"The main skills are:",{"_29":10127,"_31":10161},[10128,10139,10150],{"_29":10129,"_31":10130},[],{"_33":2680,"_35":10131,"_37":1705,"_39":10132,"_63":10133,"_65":10138,"_67":66},"oe6NE6qh",{},[10134],{"_33":3084,"_2788":10135,"_2790":10136,"_39":10137,"_67":66},[144],[2905],{},"/seed-cli -- Create, update, read, and search Seed documents. No local setup needed -- connects to remote servers.",{"_29":10140,"_31":10141},[],{"_33":2680,"_35":10142,"_37":1705,"_39":10143,"_63":10144,"_65":10149,"_67":66},"_vMTxP_g",{},[10145],{"_33":3084,"_2788":10146,"_2790":10147,"_39":10148,"_67":66},[144],[7514],{},"/seed-grpc -- Low-level gRPC access to a local Seed daemon for advanced operations.",{"_29":10151,"_31":10152},[],{"_33":2680,"_35":10153,"_37":1705,"_39":10154,"_63":10155,"_65":10160,"_67":66},"8AdKTH9O",{},[10156],{"_33":3084,"_2788":10157,"_2790":10158,"_39":10159,"_67":66},[144],[1182],{},"/seed-pdf-import -- Import PDF documents into Seed using AI-powered content recognition.",{"_33":2680,"_35":10162,"_37":1705,"_39":10163,"_63":10164,"_65":66,"_67":66},"7Czb8Vyd",{"_2719":2972},[],{"_29":10166,"_31":10167},[],{"_33":2680,"_35":10168,"_37":1705,"_39":10169,"_63":10170,"_65":10171,"_67":66},"xLe0yuzr",{},[],"Start by asking your AI agent to create a document: _\"write a document about X and publish it to Seed\"_. The agent handles key management, content formatting, and publishing automatically.",{"_33":3020,"_35":10173,"_37":1705,"_39":10174,"_63":10175,"_65":10176,"_67":66},"QmRT5Oc5",{"_2719":243},[],"After Installation",{"_29":10178,"_31":10217},[10179,10192,10199,10206],{"_29":10180,"_31":10181},[],{"_33":2680,"_35":10182,"_37":1705,"_39":10183,"_63":10184,"_65":10191,"_67":66},"wY_zUiyg",{},[10185],{"_33":2751,"_2788":10186,"_2790":10188,"_39":10190,"_67":66},[10187],258,[10189],266,{},"Once the skill is installed, you interact with it through natural language. You don't need to learn the underlying CLI commands -- the agent reads the skill instructions and translates your intent into the right operations. Behind the scenes, the skill uses seed-cli, a command-line tool that handles searching, reading, creating, and updating documents. Here are some of the operations your agent can perform on your behalf:",{"_29":10193,"_31":10194},[],{"_33":2751,"_35":10195,"_37":1705,"_39":10196,"_63":10197,"_65":10198,"_67":66},"2WAv20dw",{"_2753":9883},[],"# Search for documents across a Seed server\nseed-cli search \"server rendering\" --type hybrid --limit 5\n\n# Read a document by its hypermedia URL\nseed-cli document get hm://z6Mk.../tech-talks/server-specs\n\n# List your signing keys\nseed-cli key list\n\n# Save a draft before publishing (the agent does this automatically)\nseed-cli draft create -f content.md\n\n# Publish a document under your account\nseed-cli document create -f content.md --key mykey -p my-document",{"_29":10200,"_31":10201},[],{"_33":2680,"_35":10202,"_37":1705,"_39":10203,"_63":10204,"_65":10205,"_67":66},"Oha2R-Xp",{},[],"The most common workflows are document creation, search, and updates. When creating documents, the agent follows a draft-first approach: it writes the content to a local draft file, validates it, and shows you the result before publishing anything. This means you always get a chance to review and edit before content goes live. For searching, the agent uses semantic and keyword hybrid search, which means you can describe what you're looking for in plain language rather than exact titles. Updating existing documents is equally straightforward -- point the agent to a document URL and describe what you want changed, and it will fetch the current content, apply your edits, and show you the diff.",{"_29":10207,"_31":10208},[],{"_33":2680,"_35":10209,"_37":1705,"_39":10210,"_63":10211,"_65":10216,"_67":66},"iHHF-qLB",{},[10212],{"_33":2751,"_2788":10213,"_2790":10214,"_39":10215,"_67":66},[8431],[7712],{},"A few tips for effective use: always specify which server you're targeting if it's not the default hyper.media -- for example, _\"publish to seedteamtalks.hyper.media\"_. When working with multiple signing keys, tell the agent which identity to use upfront to avoid confusion. If you want the agent to cite other Seed documents in your content, mention that explicitly and it will search for relevant references and embed them as hypermedia links. You can also chain operations naturally -- a prompt like _\"read the document at hyper.media/tech-talks/server-specs, summarize it, and post the summary as a comment\"_ works as a single request.",{"_33":3020,"_35":10218,"_37":1705,"_39":10219,"_63":10220,"_65":10221,"_67":66},"nWde9j8G",{"_2719":243},[],"Working with Seed Skills",{"_29":10223,"_31":10240},[10224],{"_29":10225,"_31":10226},[],{"_33":2680,"_35":10227,"_37":1705,"_39":10228,"_63":10229,"_65":10239,"_67":66},"ylcEYimP",{},[10230,10234],{"_33":3084,"_2788":10231,"_2790":10232,"_39":10233,"_67":66},[1057],[6286],{},{"_33":3084,"_2788":10235,"_2790":10236,"_39":10238,"_67":66},[2819],[10237],142,{},"Use the universal installer if you work with multiple AI agents or want full control over when updates happen. Use the Claude Code marketplace if you only use Claude Code and want automatic updates. Both methods install the same skills with the same capabilities.",{"_33":3020,"_35":10241,"_37":1705,"_39":10242,"_63":10243,"_65":10244,"_67":66},"KdwXIE9P",{"_2719":243},[],"Which Method Should I Choose?",[73],"/tech-talks/seed-skills","2026-03-31T21:52:02.224Z",{"_84":1723,"_86":1724,"_190":1725,"_1643":1726,"_1244":6},{},{"_90":1579,"_94":1721},{"_35":1702,"_102":51,"_52":10252,"_68":1705,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1704],[156,1702,1705,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/seed-skills\",\"bafyreifeingaluzsjw4ibdo2uxpf5nsaaerrn7vv5wft55ylvg5hse262i\",true]",{"_117":10256,"_154":10539,"_157":10540},{"_119":10257,"_139":42,"_140":10538,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":10258,"_35":10536},{"_26":10259,"_68":1732,"_69":51,"_70":10530,"_52":10531,"_78":1741,"_80":10532,"_82":10533,"_88":10534,"_90":1742,"_92":10535,"_96":97},[10260,10267,10274,10281,10358,10412,10474,10506,10518],{"_29":10261,"_31":10262},[],{"_33":2680,"_35":10263,"_37":1742,"_39":10264,"_63":10265,"_65":10266,"_67":66},"hkZM54ZR",{},[],"Every document editor makes a promise to the writer: what you see is what you mean (get). When spacing drifts, text shrinks at deeper nesting levels, or interface elements float out of position, that promise quietly breaks. The writer may not be able to name what is wrong, but they feel it - the layout looks off, and confidence erodes.",{"_29":10268,"_31":10269},[],{"_33":2680,"_35":10270,"_37":1742,"_39":10271,"_63":10272,"_65":10273,"_67":66},"BLR3SNJJ",{},[],"We recently revisited the rendering foundations of our editor and found five visual issues that had accumulated over time. Each one was small on its own. Together, they created a compounding sense of inconsistency that undermined the editing experience.",{"_29":10275,"_31":10276},[],{"_33":2680,"_35":10277,"_37":1742,"_39":10278,"_63":10279,"_65":10280,"_67":66},"FLmkotdz",{},[],"This is the story of how we fixed them - and the single principle that unified all five changes.",{"_29":10282,"_31":10353},[10283,10345],{"_29":10284,"_31":10340},[10285,10296,10307,10318,10329],{"_29":10286,"_31":10287},[],{"_33":2680,"_35":10288,"_37":1742,"_39":10289,"_63":10290,"_65":10295,"_67":66},"MT03QlUP",{},[10291],{"_33":3084,"_2788":10292,"_2790":10293,"_39":10294,"_67":66},[144],[8172],{},"Uneven vertical rhythm. Blocks had more space above them than below, creating a lopsided cadence as content grew. The gap above a paragraph was four times the gap below it. For a single block this is barely perceptible, but across a full document the cumulative effect made the page feel top-heavy.",{"_29":10297,"_31":10298},[],{"_33":2680,"_35":10299,"_37":1742,"_39":10300,"_63":10301,"_65":10306,"_67":66},"aukK1HCP",{},[10302],{"_33":3084,"_2788":10303,"_2790":10304,"_39":10305,"_67":66},[144],[1330],{},"Shrinking text at depth. Nested content - a bullet list inside a quote, or a paragraph inside a toggle - rendered slightly smaller than its parent. And because the scaling was relative, each additional level compounded the reduction. By the third level of nesting, text was noticeably smaller than the root, even though nothing in the document model said it should be.",{"_29":10308,"_31":10309},[],{"_33":2680,"_35":10310,"_37":1742,"_39":10311,"_63":10312,"_65":10317,"_67":66},"KFfBgtTp",{},[10313],{"_33":3084,"_2788":10314,"_2790":10315,"_39":10316,"_67":66},[144],[1330],{},"Misaligned list markers. Bullet points and numbered items did not line up with the nesting indent. The gutter reserved for markers was narrower than the indentation step, so list text started at a different horizontal position than a paragraph at the same depth. This broke the vertical river of content that well-typeset documents rely on.",{"_29":10319,"_31":10320},[],{"_33":2680,"_35":10321,"_37":1742,"_39":10322,"_63":10323,"_65":10328,"_67":66},"i_Pd2kye",{},[10324],{"_33":3084,"_2788":10325,"_2790":10326,"_39":10327,"_67":66},[144],[2907],{},"Flat heading spacing. Every heading - whether a section title or a minor subheading - received the same amount of breathing room. There was no scaling by importance, no collapse rules for consecutive headings, and no suppression of top margin for the first element in a group. The result was spacing that felt arbitrary rather than intentional.",{"_29":10330,"_31":10331},[],{"_33":2680,"_35":10332,"_37":1742,"_39":10333,"_63":10334,"_65":10339,"_67":66},"7kbbuXK3",{},[10335],{"_33":3084,"_2788":10336,"_2790":10337,"_39":10338,"_67":66},[144],[2907],{},"Drifting drag handle. The side menu icon (the 6-dot grid that lets you drag and reorder blocks) was positioned based on assumptions about the old spacing. After the padding changed, it appeared about ten pixels too low — no longer aligned with the first line of text.",{"_33":2680,"_35":10341,"_37":1742,"_39":10342,"_63":10343,"_65":10344,"_67":66},"6UNSqLDw",{"_2719":3238},[],"The issues fell into a pattern: each one violated the spatial contract between blocks at different depths and types.",{"_29":10346,"_31":10347},[],{"_33":6334,"_35":10348,"_37":1742,"_39":10349,"_63":10350,"_65":10351,"_67":10352},"5NvpjP7B",{"_2719":243},[],"current editor block layout alignment and spacing","ipfs://bafkreid5t7kjcw4m2uqblfhin6rtwksxm5bmv6gmurkuxpqfzmdpaj4wc4",{"_33":3020,"_35":10354,"_37":1742,"_39":10355,"_63":10356,"_65":10357,"_67":66},"Y8vkOHft",{"_2719":243},[],"What We Found",{"_29":10359,"_31":10407},[10360,10371,10381,10392,10399],{"_29":10361,"_31":10362},[],{"_33":2680,"_35":10363,"_37":1742,"_39":10364,"_63":10365,"_65":10370,"_67":66},"iHLUUVrM",{},[10366],{"_33":3084,"_2788":10367,"_2790":10368,"_39":10369,"_67":66},[2866],[6445],{},"All five fixes follow one rule: at any nesting level, the left edge of text content aligns vertically regardless of block type.",{"_29":10372,"_31":10373},[],{"_33":6334,"_35":10374,"_37":1742,"_39":10375,"_63":10378,"_65":10379,"_67":10380},"q7ASX3-N",{"_2719":243,"_10376":10377},"width",459.8802395209581,[],"New alignment and spacing proposal","ipfs://bafkreiaogsqzvi5dr5puss3rlwajzl4vp2nmihsw67hupplyclwltzjl74",{"_29":10382,"_31":10383},[],{"_33":2680,"_35":10384,"_37":1742,"_39":10385,"_63":10386,"_65":10391,"_67":66},"N43c1SLm",{},[10387],{"_33":9788,"_2788":10388,"_2790":10389,"_39":10390,"_67":66},[8449],[9759],{},"A paragraph, a heading, a bullet item, and a code block at the same depth should all start at the same horizontal position. List markers sit outside this content edge, in a dedicated gutter. Headings get proportional breathing room, but their text still starts on the same vertical line as everything else at that level.",{"_29":10393,"_31":10394},[],{"_33":2680,"_35":10395,"_37":1742,"_39":10396,"_63":10397,"_65":10398,"_67":66},"2iF8l-N5",{},[],"This is the content-start alignment principle. It is the same approach used by Notion, Typst, and Tailwind Typography - and it is the foundation that modern document tools converge on because it produces layouts that feel structured without being rigid.",{"_29":10400,"_31":10401},[],{"_33":6334,"_35":10402,"_37":1742,"_39":10403,"_63":10404,"_65":10405,"_67":10406},"4El1Qyda",{"_2719":243},[],"Content-Start Alignment Principle mockup","ipfs://bafkreif4j7gf2ffzvqe5pbbjablauilxl2wxudabsyuhcafu7q6xmts6ca",{"_33":3020,"_35":10408,"_37":1742,"_39":10409,"_63":10410,"_65":10411,"_67":66},"pH6tgqj5",{"_2719":243},[],"The Principle",{"_29":10413,"_31":10469},[10414,10425,10436,10447,10458],{"_29":10415,"_31":10416},[],{"_33":2680,"_35":10417,"_37":1742,"_39":10418,"_63":10419,"_65":10424,"_67":66},"xPbMhe1u",{},[10420],{"_33":3084,"_2788":10421,"_2790":10422,"_39":10423,"_67":66},[144],[1330],{},"Symmetric block spacing. We replaced the asymmetric top-heavy padding with equal spacing above and below each block. A small sibling margin between consecutive blocks preserves visual separation. The result: blocks stack with a predictable, even rhythm at every depth.",{"_29":10426,"_31":10427},[],{"_33":2680,"_35":10428,"_37":1742,"_39":10429,"_63":10430,"_65":10435,"_67":66},"N25hFZzI",{},[10431],{"_33":3084,"_2788":10432,"_2790":10433,"_39":10434,"_67":66},[144],[2907],{},"Consistent text size. We removed the relative font scaling on inline content. Text now renders at the document base size regardless of how deeply it is nested. A paragraph three levels deep reads the same as one at the root - because it should.",{"_29":10437,"_31":10438},[],{"_33":2680,"_35":10439,"_37":1742,"_39":10440,"_63":10441,"_65":10446,"_67":66},"_-if-ocs",{},[10442],{"_33":3084,"_2788":10443,"_2790":10444,"_39":10445,"_67":66},[144],[2551],{},"Matched list gutter. The gutter width for list markers now matches the nesting indent exactly. When you create a bullet list under a paragraph, the bullet text aligns with the paragraph text above it. Numbered items, nested bullets, and mixed lists all follow the same spatial grid.",{"_29":10448,"_31":10449},[],{"_33":2680,"_35":10450,"_37":1742,"_39":10451,"_63":10452,"_65":10457,"_67":66},"xAtFsPFH",{},[10453],{"_33":3084,"_2788":10454,"_2790":10455,"_39":10456,"_67":66},[144],[8172],{},"Scaled heading margins. Headings now receive breathing room proportional to their level. A major section heading gets more space than a minor subheading, following a 2:1 top-to-bottom ratio. Consecutive headings collapse their spacing to avoid double gaps. The first heading in any group suppresses its top margin entirely. This hierarchy of whitespace gives documents a natural visual rhythm that mirrors their semantic structure.",{"_29":10459,"_31":10460},[],{"_33":2680,"_35":10461,"_37":1742,"_39":10462,"_63":10463,"_65":10468,"_67":66},"HWit1xC9",{},[10464],{"_33":3084,"_2788":10465,"_2790":10466,"_39":10467,"_67":66},[144],[8172],{},"Repositioned side menu. The drag handle now aligns with the center of the first line of text in every block - paragraphs, headings, lists, media, and code blocks alike. The horizontal offset was also adjusted to clear the wider list gutter without overlapping markers. The handle follows the content, not the container.",{"_33":3020,"_35":10470,"_37":1742,"_39":10471,"_63":10472,"_65":10473,"_67":66},"dS1XAP2M",{"_2719":3238},[],"What Changed",{"_29":10475,"_31":10501},[10476,10487,10494],{"_29":10477,"_31":10478},[],{"_33":2680,"_35":10479,"_37":1742,"_39":10480,"_63":10481,"_65":10486,"_67":66},"XXB0uy-g",{},[10482],{"_33":9788,"_2788":10483,"_2790":10484,"_39":10485,"_67":66},[6370],[7984],{},"These changes are invisible when done right. Nobody opens a document and thinks what excellent vertical rhythm. But they do notice when things are off - when a heading feels cramped, when nested text looks oddly small, or when the drag handle hovers in the wrong spot.",{"_29":10488,"_31":10489},[],{"_33":2680,"_35":10490,"_37":1742,"_39":10491,"_63":10492,"_65":10493,"_67":66},"xj9Jzlll",{},[],"Consistent rendering is a form of trust. It tells the writer that the tool understands the structure they are building, and it tells the reader that the content was crafted with care. By committing to content-start alignment as an invariant - not just an aspiration - we have given both writer and reader a more reliable foundation.",{"_29":10495,"_31":10496},[],{"_33":2680,"_35":10497,"_37":1742,"_39":10498,"_63":10499,"_65":10500,"_67":66},"EpGHhR0F",{},[],"The editor should disappear into the writing. These five fixes help it get closer to that goal.",{"_33":3020,"_35":10502,"_37":1742,"_39":10503,"_63":10504,"_65":10505,"_67":66},"svOY7JsG",{"_2719":243},[],"Why This Matters",{"_29":10507,"_31":10508},[],{"_33":2680,"_35":10509,"_37":1742,"_39":10510,"_63":10511,"_65":10517,"_67":66},"wztbsqIF",{},[10512],{"_33":204,"_2788":10513,"_2790":10514,"_39":10515,"_67":10516},[8222],[6610],{},"https://github.com/seed-hypermedia/seed/pull/399","You can see the changes made in this PR: https://github.com/seed-hypermedia/seed/pull/399",{"_29":10519,"_31":10520},[],{"_33":2680,"_35":10521,"_37":1732,"_39":10522,"_63":10523,"_65":10529,"_67":66},"O0VHYArk",{},[10524],{"_33":204,"_2788":10525,"_2790":10526,"_39":10527,"_67":10528},[2905],[2836],{},"https://unsplash.com/@theshubhamdhage?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText","Photo by Shubham Dhage on Unsplash",[76],"/tech-talks/improving-editor-block-rendering","2026-03-24T17:49:46.303Z",{"_84":1755,"_86":1756,"_190":1757},{},{"_90":1742,"_94":1753},{"_35":1729,"_102":51,"_52":10537,"_68":1732,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1731],1779255260508,[156,1729,1732,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/improving-editor-block-rendering\",\"bafy2bzaceddxavcanqs63a7mvjsgztcttgd445cqbuinsb6pwdjwmccgi7bsa\",true]",{"_117":10542,"_154":10568,"_157":10569},{"_119":10543,"_139":42,"_140":10567,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":10544,"_35":10565},{"_26":10545,"_68":1763,"_69":51,"_70":10560,"_52":10561,"_78":1770,"_80":1770,"_82":10562,"_88":10563,"_90":1763,"_92":10564,"_96":97},[10546,10553],{"_29":10547,"_31":10548},[],{"_33":2680,"_35":10549,"_37":1763,"_39":10550,"_63":10551,"_65":10552,"_67":66},"d0J2ZXIe",{},[],"If a document is moved with CreateRef, then a generation does not exist for it",{"_29":10554,"_31":10555},[],{"_33":2680,"_35":10556,"_37":1763,"_39":10557,"_63":10558,"_65":10559,"_67":66},"HXdI4zBL",{},[],"Is that OK and by design? In other words, is it ok for a documentRef to sometimes have no generation?",[72],"/tech-talks/q-about-ref-generations",{"_84":1783},{},{"_90":1763,"_94":1781},{"_35":1760,"_102":51,"_52":10566,"_68":1763,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1762],1779255260506,[156,1760,1763,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/q-about-ref-generations\",\"bafyreibbdfkecrtogy5ev57ecp5nbjvilnrwrb626mtvgflmeooor6zfqi\",true]",{"_117":10571,"_154":11617,"_157":11618},{"_119":10572,"_139":42,"_140":11616,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":10573,"_35":11614},{"_26":10574,"_68":1789,"_69":51,"_70":11609,"_52":11610,"_78":1796,"_80":1796,"_82":11611,"_88":11612,"_90":1789,"_92":11613,"_96":97},[10575,10591,10602,10921,11197,11582],{"_29":10576,"_31":10577},[],{"_33":2680,"_35":10578,"_37":1789,"_39":10579,"_63":10580,"_65":10590,"_67":66},"51RViuZq",{},[10581,10585],{"_33":3084,"_2788":10582,"_2790":10583,"_39":10584,"_67":66},[144],[6286],{},{"_33":2751,"_2788":10586,"_2790":10588,"_39":10589,"_67":66},[6287,6610,10587],131,[6369,7712,340],{},"Where file import plugs in: Each format parser produces HMBlockNode[], then the existing flattenToOperations() converts those into DocumentOperation[] (ReplaceBlock + MoveBlocks ops). From there, the standard signing and publishing flow takes over — no changes needed downstream.",{"_29":10592,"_31":10593},[],{"_33":2680,"_35":10594,"_37":1789,"_39":10595,"_63":10596,"_65":10601,"_67":66},"dXA18b_k",{},[10597],{"_33":2751,"_2788":10598,"_2790":10599,"_39":10600,"_67":66},[2805,2837,8306,7710],[2966,6400,6547,7522],{},"For updates (document update --replace-body), the CLI already has matchBlockIds() and computeReplaceOps() in block-diff.ts that diff old vs new block trees and emit minimal operations. File import can use the same path.",{"_29":10603,"_31":10912},[10604,10619,10630,10641,10652,10663,10679,10686,10697,10861],{"_29":10605,"_31":10606},[],{"_33":2680,"_35":10607,"_37":1789,"_39":10608,"_63":10609,"_65":10618,"_67":66},"wVGPUzte",{},[10610,10614],{"_33":3084,"_2788":10611,"_2790":10612,"_39":10613,"_67":66},[144],[170],{},{"_33":2751,"_2788":10615,"_2790":10616,"_39":10617,"_67":66},[390],[2965],{},"npm: mammoth",{"_29":10620,"_31":10621},[],{"_33":2680,"_35":10622,"_37":1789,"_39":10623,"_63":10624,"_65":10629,"_67":66},"NyykGimS",{},[10625],{"_33":3084,"_2788":10626,"_2790":10627,"_39":10628,"_67":66},[144],[1300],{},"Bundle size: ~160 KB gzipped",{"_29":10631,"_31":10632},[],{"_33":2680,"_35":10633,"_37":1789,"_39":10634,"_63":10635,"_65":10640,"_67":66},"X3RAb4bR",{},[10636],{"_33":3084,"_2788":10637,"_2790":10638,"_39":10639,"_67":66},[144],[2087],{},"Browser support: Yes",{"_29":10642,"_31":10643},[],{"_33":2680,"_35":10644,"_37":1789,"_39":10645,"_63":10646,"_65":10651,"_67":66},"35wkwUh5",{},[10647],{"_33":3084,"_2788":10648,"_2790":10649,"_39":10650,"_67":66},[144],[2918],{},"Structural quality: Excellent",{"_29":10653,"_31":10654},[],{"_33":2680,"_35":10655,"_37":1789,"_39":10656,"_63":10657,"_65":10662,"_67":66},"f8vRQBbu",{},[10658],{"_33":2751,"_2788":10659,"_2790":10660,"_39":10661,"_67":66},[2905],[912],{},"Converts .docx to clean semantic HTML. Maps Word styles to HTML elements:",{"_29":10664,"_31":10665},[],{"_33":2680,"_35":10666,"_37":1789,"_39":10667,"_63":10668,"_65":10678,"_67":66},"N4K3Li8A",{},[10669],{"_33":2751,"_2788":10670,"_2790":10674,"_39":10677,"_67":66},[6790,6569,9385,8688,10671,10672,8789,10673],147,154,193,[6804,2823,6366,6674,6387,10675,6367,10676],158,198,{},"| Word Style | HTML Output | |-----------|-------------| | Heading 1 |

| | Heading 2 |

| | Bold | | | Italic | | | Lists |
/
| | Tables | | | Images | (base64) |",{"_29":10680,"_31":10681},[],{"_33":2680,"_35":10682,"_37":1789,"_39":10683,"_63":10684,"_65":10685,"_67":66},"cFjaz6f9",{},[],"Custom style mappings are supported.",{"_29":10687,"_31":10688},[],{"_33":2680,"_35":10689,"_37":1789,"_39":10690,"_63":10691,"_65":10696,"_67":66},"7EQeqDsA",{},[10692],{"_33":3084,"_2788":10693,"_2790":10694,"_39":10695,"_67":66},[144],[1835],{},"Repo: https://github.com/mwilliamson/mammoth.js",{"_29":10698,"_31":10856},[10699,10706,10717,10728,10739,10812,10823,10838,10849],{"_29":10700,"_31":10701},[],{"_33":2680,"_35":10702,"_37":1789,"_39":10703,"_63":10704,"_65":10705,"_67":66},"EwBA21D4",{},[],"Two possible conversion paths:",{"_29":10707,"_31":10708},[],{"_33":2680,"_35":10709,"_37":1789,"_39":10710,"_63":10711,"_65":10716,"_67":66},"qzzSc2hH",{},[10712],{"_33":3084,"_2788":10713,"_2790":10714,"_39":10715,"_67":66},[144],[6424],{},"Path A — mammoth → HTML → BlockNote's HTML-to-blocks",{"_29":10718,"_31":10719},[],{"_33":2680,"_35":10720,"_37":1789,"_39":10721,"_63":10722,"_65":10727,"_67":66},"BtrzXAtf",{},[10723],{"_33":2751,"_2788":10724,"_2790":10725,"_39":10726,"_67":66},[2839,6365],[2792,2893],{},"BlockNote (used in packages/editor) already has tryParseHTMLToBlocks() which converts HTML into its internal block model. From there, the existing editor-to-HMBlockNode conversion can be reused. This path gets the richest output with minimal new code but couples the import to the editor package.",{"_29":10729,"_31":10730},[],{"_33":2680,"_35":10731,"_37":1789,"_39":10732,"_63":10733,"_65":10738,"_67":66},"8TOc2U_J",{},[10734],{"_33":3084,"_2788":10735,"_2790":10736,"_39":10737,"_67":66},[144],[6572],{},"Path B — mammoth → HTML → custom HMBlockNode[] mapper",{"_29":10740,"_31":10807},[10741,10752,10763,10774,10785,10796],{"_29":10742,"_31":10743},[],{"_33":2680,"_35":10744,"_37":1789,"_39":10745,"_63":10746,"_65":10751,"_67":66},"Vrvo1SKk",{},[10747],{"_33":2751,"_2788":10748,"_2790":10749,"_39":10750,"_67":66},[144,390,2965],[1835,2905,6365],{},"
–
→ {type: 'Heading', text, annotations} with heading-level nesting",{"_29":10753,"_31":10754},[],{"_33":2680,"_35":10755,"_37":1789,"_39":10756,"_63":10757,"_65":10762,"_67":66},"-KhtFEu7",{},[10758],{"_33":2751,"_2788":10759,"_2790":10760,"_39":10761,"_67":66},[144,649],[170,2878],{},"
→ {type: 'Paragraph', text, annotations}",{"_29":10764,"_31":10765},[],{"_33":2680,"_35":10766,"_37":1789,"_39":10767,"_63":10768,"_65":10773,"_67":66},"-rwHuBn8",{},[10769],{"_33":2751,"_2788":10770,"_2790":10771,"_39":10772,"_67":66},[144,7514,1182,1330,6424,2793],[1057,912,2836,6286,6612,10108],{},", , , → annotation spans with starts/ends character positions",{"_29":10775,"_31":10776},[],{"_33":2680,"_35":10777,"_37":1789,"_39":10778,"_63":10779,"_65":10784,"_67":66},"jyTNr64o",{},[10780],{"_33":2751,"_2788":10781,"_2790":10782,"_39":10783,"_67":66},[144,882,3243],[1835,1300,6426],{},"
/ → Paragraph blocks with childrenType: 'Unordered' | 'Ordered'",{"_29":10786,"_31":10787},[],{"_33":2680,"_35":10788,"_37":1789,"_39":10789,"_63":10790,"_65":10795,"_67":66},"RQkm-6VK",{},[10791],{"_33":2751,"_2788":10792,"_2790":10793,"_39":10794,"_67":66},[144],[882],{},"
→ Code block (current CLI behavior) or future Table block type",{"_29":10797,"_31":10798},[],{"_33":2680,"_35":10799,"_37":1789,"_39":10800,"_63":10801,"_65":10806,"_67":66},"KzwUDfb-",{},[10802],{"_33":2751,"_2788":10803,"_2790":10804,"_39":10805,"_67":66},[144,8079],[390,2894],{}," → extract base64 data, upload via blob storage, create {type: 'Image', link: ipfsUrl}",{"_33":2680,"_35":10808,"_37":1789,"_39":10809,"_63":10810,"_65":10811,"_67":66},"tiETJwxC",{"_2719":2972},[],"Write a standalone HTML-to-HMBlockNode converter. Walk the DOM tree and map:",{"_29":10813,"_31":10814},[],{"_33":2680,"_35":10815,"_37":1789,"_39":10816,"_63":10817,"_65":10822,"_67":66},"bB1pl5yx",{},[10818],{"_33":2751,"_2788":10819,"_2790":10820,"_39":10821,"_67":66},[7514,6568,8281],[439,175,8431],{},"Then call flattenToOperations(blocks) and feed into the standard document create or document update flow.",{"_29":10824,"_31":10825},[],{"_33":2680,"_35":10826,"_37":1789,"_39":10827,"_63":10828,"_65":10837,"_67":66},"HBajGde8",{},[10829,10833],{"_33":3084,"_2788":10830,"_2790":10831,"_39":10832,"_67":66},[144],[2551],{},{"_33":2751,"_2788":10834,"_2790":10835,"_39":10836,"_67":66},[2853,6671],[2851,7537],{},"Image handling note: mammoth extracts images as base64 tags. These need to be uploaded to blob storage (UnixFS chunking, ~256KB chunks, via storeBlobs with 4MB message limit) and replaced with IPFS CID links before creating the Image blocks.",{"_29":10839,"_31":10840},[],{"_33":2680,"_35":10841,"_37":1789,"_39":10842,"_63":10843,"_65":10848,"_67":66},"4AtwCnQ7",{},[10844],{"_33":3084,"_2788":10845,"_2790":10846,"_39":10847,"_67":66},[144],[7703],{},"CLI usage would look like:",{"_29":10850,"_31":10851},[],{"_33":2751,"_35":10852,"_37":1789,"_39":10853,"_63":10854,"_65":10855,"_67":66},"gYzHOHwG",{"_2753":9883},[],"seed-cli document create z6Mk... --title \"Imported Doc\" --docx report.docx --key main\nseed-cli document update hm://z6Mk.../doc --replace-docx updated.docx --key main\n",{"_33":3020,"_35":10857,"_37":1789,"_39":10858,"_63":10859,"_65":10860,"_67":66},"ZMq4ty6n",{"_2719":243},[],"SDK Integration",{"_29":10862,"_31":10903},[10863,10878,10885,10896],{"_29":10864,"_31":10865},[],{"_33":2680,"_35":10866,"_37":1789,"_39":10867,"_63":10868,"_65":10877,"_67":66},"YxSauU8b",{},[10869,10873],{"_33":3084,"_2788":10870,"_2790":10871,"_39":10872,"_67":66},[144],[170],{},{"_33":2751,"_2788":10874,"_2790":10875,"_39":10876,"_67":66},[390],[2821],{},"npm: officeparser",{"_29":10879,"_31":10880},[],{"_33":2680,"_35":10881,"_37":1789,"_39":10882,"_63":10883,"_65":10884,"_67":66},"zpLJmVBd",{},[],"Produces a hierarchical AST (paragraphs, headings, tables, lists, bold/italic)",{"_29":10886,"_31":10887},[],{"_33":2680,"_35":10888,"_37":1789,"_39":10889,"_63":10890,"_65":10895,"_67":66},"Oiq4fdJ5",{},[10891],{"_33":2751,"_2788":10892,"_2790":10893,"_39":10894,"_67":66},[2805,2551,6286,6695,2920],[2918,3926,2806,439,2966],{},"Also handles .pptx, .xlsx, .odt, .pdf, .rtf",{"_29":10897,"_31":10898},[],{"_33":2680,"_35":10899,"_37":1789,"_39":10900,"_63":10901,"_65":10902,"_67":66},"7DRoPKEz",{},[],"Newer and less battle-tested than mammoth",{"_33":3020,"_35":10904,"_37":1789,"_39":10905,"_63":10906,"_65":10911,"_67":66},"MSjBS70I",{"_2719":2972},[10907],{"_33":2751,"_2788":10908,"_2790":10909,"_39":10910,"_67":66},[2805],[3926],{},"Alternative: officeparser",{"_33":3020,"_35":10913,"_37":1789,"_39":10914,"_63":10915,"_65":10920,"_67":66},"nbFZff6k",{"_2719":2972},[10916],{"_33":2751,"_2788":10917,"_2790":10918,"_39":10919,"_67":66},[882],[912],{},"DOCX — mammoth",{"_29":10922,"_31":11188},[10923,10992,11072],{"_29":10924,"_31":10983},[10925,10940,10951,10962,10969,10976],{"_29":10926,"_31":10927},[],{"_33":2680,"_35":10928,"_37":1789,"_39":10929,"_63":10930,"_65":10939,"_67":66},"KOHxuxzw",{},[10931,10935],{"_33":3084,"_2788":10932,"_2790":10933,"_39":10934,"_67":66},[144],[170],{},{"_33":2751,"_2788":10936,"_2790":10937,"_39":10938,"_67":66},[390],[2551],{},"npm: read-excel-file",{"_29":10941,"_31":10942},[],{"_33":2680,"_35":10943,"_37":1789,"_39":10944,"_63":10945,"_65":10950,"_67":66},"2I_4V6an",{},[10946],{"_33":3084,"_2788":10947,"_2790":10948,"_39":10949,"_67":66},[144],[1300],{},"Bundle size: ~37 KB gzipped",{"_29":10952,"_31":10953},[],{"_33":2680,"_35":10954,"_37":1789,"_39":10955,"_63":10956,"_65":10961,"_67":66},"1eMdJ7OR",{},[10957],{"_33":3084,"_2788":10958,"_2790":10959,"_39":10960,"_67":66},[144],[2087],{},"Browser support: Yes (browser-first design)",{"_29":10963,"_31":10964},[],{"_33":2680,"_35":10965,"_37":1789,"_39":10966,"_63":10967,"_65":10968,"_67":66},"JLk1k41U",{},[],"Returns rows as arrays of cells (string/number/Date/boolean)",{"_29":10970,"_31":10971},[],{"_33":2680,"_35":10972,"_37":1789,"_39":10973,"_63":10974,"_65":10975,"_67":66},"ueU5YjcO",{},[],"Supports schema-based parsing for typed JSON objects",{"_29":10977,"_31":10978},[],{"_33":2680,"_35":10979,"_37":1789,"_39":10980,"_63":10981,"_65":10982,"_67":66},"RCxz1xTT",{},[],"Does not handle formulas",{"_33":3020,"_35":10984,"_37":1789,"_39":10985,"_63":10986,"_65":10991,"_67":66},"aQT-hPE1",{"_2719":2972},[10987],{"_33":2751,"_2788":10988,"_2790":10989,"_39":10990,"_67":66},[7514],[3926],{},"Option A: read-excel-file (lightweight, recommended)",{"_29":10993,"_31":11063},[10994,11009,11020,11030,11037,11052],{"_29":10995,"_31":10996},[],{"_33":2680,"_35":10997,"_37":1789,"_39":10998,"_63":10999,"_65":11008,"_67":66},"p3srzukZ",{},[11000,11004],{"_33":3084,"_2788":11001,"_2790":11002,"_39":11003,"_67":66},[144],[170],{},{"_33":2751,"_2788":11005,"_2790":11006,"_39":11007,"_67":66},[390],[2905],{},"npm: xlsx",{"_29":11010,"_31":11011},[],{"_33":2680,"_35":11012,"_37":1789,"_39":11013,"_63":11014,"_65":11019,"_67":66},"36S2O5v6",{},[11015],{"_33":3084,"_2788":11016,"_2790":11017,"_39":11018,"_67":66},[144],[1300],{},"Bundle size: ~300–500 KB gzipped",{"_29":11021,"_31":11022},[],{"_33":2680,"_35":11023,"_37":1789,"_39":11024,"_63":11025,"_65":10640,"_67":66},"E7SdQ8Sf",{},[11026],{"_33":3084,"_2788":11027,"_2790":11028,"_39":11029,"_67":66},[144],[2087],{},{"_29":11031,"_31":11032},[],{"_33":2680,"_35":11033,"_37":1789,"_39":11034,"_63":11035,"_65":11036,"_67":66},"zFUHVkA-",{},[],"Handles merged cells, formulas, number formatting",{"_29":11038,"_31":11039},[],{"_33":2680,"_35":11040,"_37":1789,"_39":11041,"_63":11042,"_65":11051,"_67":66},"LFXxb1GH",{},[11043,11047],{"_33":3084,"_2788":11044,"_2790":11045,"_39":11046,"_67":66},[144],[649],{},{"_33":2751,"_2788":11048,"_2790":11049,"_39":11050,"_67":66},[6289],[6573],{},"Caveat: npm version stuck at 0.18.5; newer versions distributed via cdn.sheetjs.com",{"_29":11053,"_31":11054},[],{"_33":2680,"_35":11055,"_37":1789,"_39":11056,"_63":11057,"_65":11062,"_67":66},"5e0kKEJd",{},[11058],{"_33":3084,"_2788":11059,"_2790":11060,"_39":11061,"_67":66},[144],[1835],{},"Docs: https://docs.sheetjs.com/",{"_33":3020,"_35":11064,"_37":1789,"_39":11065,"_63":11066,"_65":11071,"_67":66},"K1whkQVo",{"_2719":2972},[11067],{"_33":2751,"_2788":11068,"_2790":11069,"_39":11070,"_67":66},[7514],[912],{},"Option B: xlsx / SheetJS (full-featured)",{"_29":11073,"_31":11184},[11074,11081,11092,11099,11137,11152,11162,11169],{"_29":11075,"_31":11076},[],{"_33":2680,"_35":11077,"_37":1789,"_39":11078,"_63":11079,"_65":11080,"_67":66},"y1wNA0Jr",{},[],"Spreadsheets don't map to the existing markdown parser at all — they need a dedicated converter.",{"_29":11082,"_31":11083},[],{"_33":2680,"_35":11084,"_37":1789,"_39":11085,"_63":11086,"_65":11091,"_67":66},"SN7IgHmW",{},[11087],{"_33":3084,"_2788":11088,"_2790":11089,"_39":11090,"_67":66},[144],[1182],{},"Conversion flow:",{"_29":11093,"_31":11094},[],{"_33":2751,"_35":11095,"_37":1789,"_39":11096,"_63":11097,"_65":11098,"_67":66},"iVA2cskX",{"_2753":66},[],".xlsx → read-excel-file/SheetJS → rows[][] per sheet\n → for each sheet:\n Heading block (sheet name)\n → Table-like structure as child blocks\n → flattenToOperations(blocks)\n → standard signing/publish flow\n",{"_29":11100,"_31":11128},[11101,11117],{"_29":11102,"_31":11103},[],{"_33":2680,"_35":11104,"_37":1789,"_39":11105,"_63":11106,"_65":11116,"_67":66},"krqr2J2w",{},[11107,11111],{"_33":3084,"_2788":11108,"_2790":11109,"_39":11110,"_67":66},[144],[2087],{},{"_33":2751,"_2788":11112,"_2790":11113,"_39":11115,"_67":66},[7759],[11114],169,{},"As a Code block (simplest, matches current CLI behavior for tables): Render the spreadsheet as a markdown/CSV table string inside a {type: 'code-block', text: csvString} block. The CLI already renders markdown tables as Code blocks.",{"_29":11118,"_31":11119},[],{"_33":2680,"_35":11120,"_37":1789,"_39":11121,"_63":11122,"_65":11127,"_67":66},"NnoCuLNR",{},[11123],{"_33":3084,"_2788":11124,"_2790":11125,"_39":11126,"_67":66},[144],[7703],{},"As nested Paragraph blocks (richer but verbose): Each row becomes a Paragraph block, cells separated by formatting. Poor UX for large sheets.",{"_33":2680,"_35":11129,"_37":1789,"_39":11130,"_63":11131,"_65":11136,"_67":66},"ayBcg64i",{"_2719":3238},[11132],{"_33":3084,"_2788":11133,"_2790":11134,"_39":11135,"_67":66},[144],[2836],{},"Block mapping options:",{"_29":11138,"_31":11139},[],{"_33":2680,"_35":11140,"_37":1789,"_39":11141,"_63":11142,"_65":11151,"_67":66},"LNnpW0HO",{},[11143,11147],{"_33":3084,"_2788":11144,"_2790":11145,"_39":11146,"_67":66},[144],[2907],{},{"_33":2751,"_2788":11148,"_2790":11149,"_39":11150,"_67":66},[7521],[8647],{},"Multi-sheet handling: Each worksheet becomes a Heading block with the sheet's content as children. The flattenToOperations() function already handles nested parent-child block trees via MoveBlocks operations.",{"_29":11153,"_31":11154},[],{"_33":2680,"_35":11155,"_37":1789,"_39":11156,"_63":11157,"_65":10848,"_67":66},"pSPCPxSr",{},[11158],{"_33":3084,"_2788":11159,"_2790":11160,"_39":11161,"_67":66},[144],[7703],{},{"_29":11163,"_31":11164},[],{"_33":2751,"_35":11165,"_37":1789,"_39":11166,"_63":11167,"_65":11168,"_67":66},"Zi9oulog",{"_2753":9883},[],"seed-cli document create z6Mk... --title \"Q4 Report\" --xlsx data.xlsx --key main\n# Each sheet becomes a section under the document\n",{"_29":11170,"_31":11171},[],{"_33":2680,"_35":11172,"_37":1789,"_39":11173,"_63":11174,"_65":11183,"_67":66},"dlulKxYs",{},[11175,11179],{"_33":3084,"_2788":11176,"_2790":11177,"_39":11178,"_67":66},[144],[3926],{},{"_33":2751,"_2788":11180,"_2790":11181,"_39":11182,"_67":66},[3088],[6382],{},"Practical recommendation: Start with Option A (read-excel-file) rendering sheets as Code blocks containing markdown tables. This requires zero schema changes and works with the existing pipeline immediately.",{"_33":3020,"_35":11185,"_37":1789,"_39":11186,"_63":11187,"_65":10860,"_67":66},"HTZMLAM7",{"_2719":243},[],{"_33":3020,"_35":11189,"_37":1789,"_39":11190,"_63":11191,"_65":11196,"_67":66},"R8itN9xh",{"_2719":243},[11192],{"_33":2751,"_2788":11193,"_2790":11194,"_39":11195,"_67":66},[882,7703],[2836,491],{},"XLSX — read-excel-file or xlsx (SheetJS)",{"_29":11198,"_31":11573},[11199,11214,11225,11236,11247,11307,11318,11492],{"_29":11200,"_31":11201},[],{"_33":2680,"_35":11202,"_37":1789,"_39":11203,"_63":11204,"_65":11213,"_67":66},"LLS7gZvG",{},[11205,11209],{"_33":3084,"_2788":11206,"_2790":11207,"_39":11208,"_67":66},[144],[170],{},{"_33":2751,"_2788":11210,"_2790":11211,"_39":11212,"_67":66},[390],[2087],{},"npm: pdfjs-dist",{"_29":11215,"_31":11216},[],{"_33":2680,"_35":11217,"_37":1789,"_39":11218,"_63":11219,"_65":11224,"_67":66},"FaLFuNir",{},[11220],{"_33":3084,"_2788":11221,"_2790":11222,"_39":11223,"_67":66},[144],[1300],{},"Bundle size: ~400–800 KB gzipped (heavy)",{"_29":11226,"_31":11227},[],{"_33":2680,"_35":11228,"_37":1789,"_39":11229,"_63":11230,"_65":11235,"_67":66},"68eh3J-x",{},[11231],{"_33":3084,"_2788":11232,"_2790":11233,"_39":11234,"_67":66},[144],[2087],{},"Browser support: Yes (this is Firefox's PDF engine)",{"_29":11237,"_31":11238},[],{"_33":2680,"_35":11239,"_37":1789,"_39":11240,"_63":11241,"_65":11246,"_67":66},"MG_NgQkA",{},[11242],{"_33":3084,"_2788":11243,"_2790":11244,"_39":11245,"_67":66},[144],[2918],{},"Structural quality: Low — PDFs have no semantic structure",{"_29":11248,"_31":11293},[11249,11260,11271,11282],{"_29":11250,"_31":11251},[],{"_33":2680,"_35":11252,"_37":1789,"_39":11253,"_63":11254,"_65":11259,"_67":66},"XVZ2rPFc",{},[11255],{"_33":3084,"_2788":11256,"_2790":11257,"_39":11258,"_67":66},[144],[1057],{},"Headings: larger font size",{"_29":11261,"_31":11262},[],{"_33":2680,"_35":11263,"_37":1789,"_39":11264,"_63":11265,"_65":11270,"_67":66},"NQHuSbG6",{},[11266],{"_33":3084,"_2788":11267,"_2790":11268,"_39":11269,"_67":66},[144],[7514],{},"Paragraphs: spatial proximity grouping",{"_29":11272,"_31":11273},[],{"_33":2680,"_35":11274,"_37":1789,"_39":11275,"_63":11276,"_65":11281,"_67":66},"L7_Gu8G2",{},[11277],{"_33":3084,"_2788":11278,"_2790":11279,"_39":11280,"_67":66},[144],[649],{},"Tables: grid-aligned text detection",{"_29":11283,"_31":11284},[],{"_33":2680,"_35":11285,"_37":1789,"_39":11286,"_63":11287,"_65":11292,"_67":66},"yxztKwqq",{},[11288],{"_33":3084,"_2788":11289,"_2790":11290,"_39":11291,"_67":66},[144],[649],{},"Images: separate rendering pass",{"_33":2680,"_35":11294,"_37":1789,"_39":11295,"_63":11296,"_65":11306,"_67":66},"SnJ20UA6",{"_2719":2972},[11297,11301],{"_33":2751,"_2788":11298,"_2790":11299,"_39":11300,"_67":66},[2854],[6366],{},{"_33":3084,"_2788":11302,"_2790":11303,"_39":11305,"_67":66},[7984],[11304],126,{},"Extracts text items with position coordinates (x, y), font info, and text content per page via page.getTextContent(). Does not natively give you headings, paragraphs, or tables — you must reconstruct structure from:",{"_29":11308,"_31":11309},[],{"_33":2680,"_35":11310,"_37":1789,"_39":11311,"_63":11312,"_65":11317,"_67":66},"mXOnmfdz",{},[11313],{"_33":3084,"_2788":11314,"_2790":11315,"_39":11316,"_67":66},[144],[1835],{},"Repo: https://github.com/mozilla/pdf.js",{"_29":11319,"_31":11488},[11320,11331,11341,11348,11392,11438,11455,11465,11472],{"_29":11321,"_31":11322},[],{"_33":2680,"_35":11323,"_37":1789,"_39":11324,"_63":11325,"_65":11330,"_67":66},"s_leYnDr",{},[11326],{"_33":2751,"_2788":11327,"_2790":11328,"_39":11329,"_67":66},[2792,9759],[2878,9791],{},"PDF is the hardest format because pdfjs-dist returns positioned text items, not semantic blocks. A heuristic layer is needed between the parser and HMBlockNode[].",{"_29":11332,"_31":11333},[],{"_33":2680,"_35":11334,"_37":1789,"_39":11335,"_63":11336,"_65":11091,"_67":66},"tj9YtoEV",{},[11337],{"_33":3084,"_2788":11338,"_2790":11339,"_39":11340,"_67":66},[144],[1182],{},{"_29":11342,"_31":11343},[],{"_33":2751,"_35":11344,"_37":1789,"_39":11345,"_63":11346,"_65":11347,"_67":66},"IEldMsw4",{"_2753":66},[],".pdf → pdfjs getTextContent() → TextItem[] with {str, transform, fontName, ...}\n → heuristic grouping:\n 1. Group text items into lines (same Y coordinate within tolerance)\n 2. Group lines into paragraphs (vertical gap < threshold)\n 3. Detect headings (font size > body font size)\n 4. Detect lists (lines starting with \"•\", \"-\", \"1.\")\n → HMBlockNode[] (mostly Paragraph + Heading blocks)\n → flattenToOperations(blocks)\n → standard signing/publish flow\n",{"_29":11349,"_31":11383},[11350,11361,11372],{"_29":11351,"_31":11352},[],{"_33":2680,"_35":11353,"_37":1789,"_39":11354,"_63":11355,"_65":11360,"_67":66},"4Q6C9sDd",{},[11356],{"_33":2751,"_2788":11357,"_2790":11358,"_39":11359,"_67":66},[2918],[8222],{},"Large-font text → {type: 'Heading', text} with annotations",{"_29":11362,"_31":11363},[],{"_33":2680,"_35":11364,"_37":1789,"_39":11365,"_63":11366,"_65":11371,"_67":66},"OKUPeTd4",{},[11367],{"_33":2751,"_2788":11368,"_2790":11369,"_39":11370,"_67":66},[2839],[2878],{},"Body text groups → {type: 'Paragraph', text} with bold/italic from font metadata",{"_29":11373,"_31":11374},[],{"_33":2680,"_35":11375,"_37":1789,"_39":11376,"_63":11377,"_65":11382,"_67":66},"_Cw0tqXg",{},[11378],{"_33":2751,"_2788":11379,"_2790":11380,"_39":11381,"_67":66},[783],[7520],{},"Bullet/numbered patterns → Paragraph with childrenType: 'Unordered' | 'Ordered'",{"_33":2680,"_35":11384,"_37":1789,"_39":11385,"_63":11386,"_65":11391,"_67":66},"eVSOcyTS",{"_2719":2972},[11387],{"_33":3084,"_2788":11388,"_2790":11389,"_39":11390,"_67":66},[144],[6695],{},"What maps cleanly to HMBlockNode:",{"_29":11393,"_31":11429},[11394,11401,11408,11415,11422],{"_29":11395,"_31":11396},[],{"_33":2680,"_35":11397,"_37":1789,"_39":11398,"_63":11399,"_65":11400,"_67":66},"9oLUhfrH",{},[],"Multi-column layouts (text items interleave columns)",{"_29":11402,"_31":11403},[],{"_33":2680,"_35":11404,"_37":1789,"_39":11405,"_63":11406,"_65":11407,"_67":66},"af6BR6S-",{},[],"Tables (must detect grid alignment — complex heuristic)",{"_29":11409,"_31":11410},[],{"_33":2680,"_35":11411,"_37":1789,"_39":11412,"_63":11413,"_65":11414,"_67":66},"ziEV3kFm",{},[],"Images (requires separate canvas rendering per page, then blob upload)",{"_29":11416,"_31":11417},[],{"_33":2680,"_35":11418,"_37":1789,"_39":11419,"_63":11420,"_65":11421,"_67":66},"CAFJJHhr",{},[],"Headers/footers (appear as regular text items)",{"_29":11423,"_31":11424},[],{"_33":2680,"_35":11425,"_37":1789,"_39":11426,"_63":11427,"_65":11428,"_67":66},"W2nj3XK3",{},[],"Mathematical formulas (not extractable as LaTeX)",{"_33":2680,"_35":11430,"_37":1789,"_39":11431,"_63":11432,"_65":11437,"_67":66},"L2iFqA5x",{"_2719":2972},[11433],{"_33":3084,"_2788":11434,"_2790":11435,"_39":11436,"_67":66},[144],[2836],{},"What doesn't map well:",{"_29":11439,"_31":11440},[],{"_33":2680,"_35":11441,"_37":1789,"_39":11442,"_63":11443,"_65":11454,"_67":66},"Od6pxQwu",{},[11444,11448],{"_33":3084,"_2788":11445,"_2790":11446,"_39":11447,"_67":66},[144,3243,2890],[2805,6567,2818],{},{"_33":2751,"_2788":11449,"_2790":11451,"_39":11453,"_67":66},[2805,6567,11450,8248],255,[3243,2890,11452,10189],261,{},"The existing parseInlineFormatting() in markdown.ts builds annotation spans from character positions. The same pattern applies here — as you concatenate text items into a paragraph string, track font changes to create Bold/Italic annotations with correct starts/ends offsets.",{"_29":11456,"_31":11457},[],{"_33":2680,"_35":11458,"_37":1789,"_39":11459,"_63":11460,"_65":10848,"_67":66},"0A2dunHA",{},[11461],{"_33":3084,"_2788":11462,"_2790":11463,"_39":11464,"_67":66},[144],[7703],{},{"_29":11466,"_31":11467},[],{"_33":2751,"_35":11468,"_37":1789,"_39":11469,"_63":11470,"_65":11471,"_67":66},"vvVqhIUG",{"_2753":9883},[],"seed-cli document create z6Mk... --title \"Research Paper\" --pdf paper.pdf --key main\n# Best-effort text extraction with heuristic heading detection\n",{"_29":11473,"_31":11474},[],{"_33":2680,"_35":11475,"_37":1789,"_39":11476,"_63":11477,"_65":11487,"_67":66},"gMSpplYq",{},[11478,11482],{"_33":3084,"_2788":11479,"_2790":11480,"_39":11481,"_67":66},[144],[3926],{},{"_33":2751,"_2788":11483,"_2790":11484,"_39":11486,"_67":66},[7710],[11485],118,{},"Practical recommendation: Offer this as a \"basic text import\" rather than promising structural fidelity. The --verbose flag could show warnings about low-confidence heading detection or skipped elements.",{"_33":3020,"_35":11489,"_37":1789,"_39":11490,"_63":11491,"_65":10860,"_67":66},"XjdD5vo5",{"_2719":243},[],{"_29":11493,"_31":11564},[11494,11509,11520,11527,11538,11549],{"_29":11495,"_31":11496},[],{"_33":2680,"_35":11497,"_37":1789,"_39":11498,"_63":11499,"_65":11508,"_67":66},"2qOj0HIx",{},[11500,11504],{"_33":3084,"_2788":11501,"_2790":11502,"_39":11503,"_67":66},[144],[170],{},{"_33":2751,"_2788":11505,"_2790":11506,"_39":11507,"_67":66},[390],[7514],{},"npm: unpdf",{"_29":11510,"_31":11511},[],{"_33":2680,"_35":11512,"_37":1789,"_39":11513,"_63":11514,"_65":11519,"_67":66},"l5hxcjw_",{},[11515],{"_33":3084,"_2788":11516,"_2790":11517,"_39":11518,"_67":66},[144],[1300],{},"Bundle size: ~390 KB gzipped",{"_29":11521,"_31":11522},[],{"_33":2680,"_35":11523,"_37":1789,"_39":11524,"_63":11525,"_65":11526,"_67":66},"4s6cxeYz",{},[],"Cleaner async/await API wrapper around pdf.js",{"_29":11528,"_31":11529},[],{"_33":2680,"_35":11530,"_37":1789,"_39":11531,"_63":11532,"_65":11537,"_67":66},"yhdCY_1w",{},[11533],{"_33":2751,"_2788":11534,"_2790":11535,"_39":11536,"_67":66},[2905,2836,3243],[2551,2792,2966],{},"Methods: extractText, extractLinks, getMeta",{"_29":11539,"_31":11540},[],{"_33":2680,"_35":11541,"_37":1789,"_39":11542,"_63":11543,"_65":11548,"_67":66},"4ee19moK",{},[11544],{"_33":3084,"_2788":11545,"_2790":11546,"_39":11547,"_67":66},[144],[1835],{},"Repo: https://github.com/unjs/unpdf",{"_29":11550,"_31":11551},[],{"_33":2680,"_35":11552,"_37":1789,"_39":11553,"_63":11554,"_65":11563,"_67":66},"2atV15AH",{},[11555,11559],{"_33":3084,"_2788":11556,"_2790":11557,"_39":11558,"_67":66},[144],[1057],{},{"_33":2751,"_2788":11560,"_2790":11561,"_39":11562,"_67":66},[7514],[2907],{},"SDK note: extractText returns plain string per page — simpler but loses all font/position metadata needed for heading detection. Only viable for plain-text-only import.",{"_33":3020,"_35":11565,"_37":1789,"_39":11566,"_63":11567,"_65":11572,"_67":66},"hMV_pvpI",{"_2719":2972},[11568],{"_33":2751,"_2788":11569,"_2790":11570,"_39":11571,"_67":66},[2805],[2918],{},"Alternative: unpdf",{"_33":3020,"_35":11574,"_37":1789,"_39":11575,"_63":11576,"_65":11581,"_67":66},"rFiepJWU",{"_2719":2972},[11577],{"_33":2751,"_2788":11578,"_2790":11579,"_39":11580,"_67":66},[649],[1182],{},"PDF — pdfjs-dist",{"_29":11583,"_31":11604},[11584,11597],{"_29":11585,"_31":11586},[],{"_33":2680,"_35":11587,"_37":1789,"_39":11588,"_63":11589,"_65":11596,"_67":66},"bG7LIUOh",{},[11590],{"_33":2751,"_2788":11591,"_2790":11593,"_39":11595,"_67":66},[2851,8201,6791,11592,340],129,[6426,7710,11304,10671,11594],166,{},"All three formats converge at the same point: once you have HMBlockNode[], the existing flattenToOperations() → createChange() → createVersionRef() → client.publish() pipeline handles the rest unchanged.",{"_29":11598,"_31":11599},[],{"_33":2680,"_35":11600,"_37":1789,"_39":11601,"_63":11602,"_65":11603,"_67":66},"qpD_4ZEr",{},[],"DOCX is the clear quick win — mammoth's HTML output maps almost 1:1 to the block model. XLSX is straightforward but limited to table-like rendering. PDF requires the most custom heuristic code for the least structural fidelity.",{"_33":3020,"_35":11605,"_37":1789,"_39":11606,"_63":11607,"_65":11608,"_67":66},"xgcNG8zD",{"_2719":243},[],"Summary",[74],"/tech-talks/file-import-libraries-research",{"_84":1809,"_86":1810},{},{"_90":1789,"_94":1807},{"_35":1786,"_102":51,"_52":11615,"_68":1789,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1788],1779255260493,[156,1786,1789,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/file-import-libraries-research\",\"bafy2bzacebacooy7bmu7675fwf4ww5coyrc3ii6wa4v43w675yv6mqu3ft76a\",true]",{"_117":11620,"_154":11660,"_157":11661},{"_119":11621,"_139":42,"_140":11659,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":11622,"_35":11657},{"_26":11623,"_68":1846,"_69":51,"_70":11652,"_52":11653,"_78":1853,"_80":1853,"_82":11654,"_88":11655,"_90":1846,"_92":11656,"_96":97},[11624,11631,11638,11645],{"_29":11625,"_31":11626},[],{"_33":2680,"_35":11627,"_37":1846,"_39":11628,"_63":11629,"_65":11630,"_67":66},"q-IJLqU4",{},[],"The notification server needs to send a notifications list to the client, to make sure the user sees all of their notifications.",{"_29":11632,"_31":11633},[],{"_33":2680,"_35":11634,"_37":1846,"_39":11635,"_63":11636,"_65":11637,"_67":66},"QHHIaoLo",{},[],"This is relevant because the client may not have all the same data available as the notification server has. The notification server is expected to see \"everything\" because it sends out the emails, etc.",{"_29":11639,"_31":11640},[],{"_33":2680,"_35":11641,"_37":1846,"_39":11642,"_63":11643,"_65":11644,"_67":66},"FqiyrzVM",{},[],"But, the notification list is ever-increasing. So the server should either support pagination (and the client will fetch things it already has - only stopping when the user stops scrolling down), or we should develop some range-based-set-reconciliation.",{"_29":11646,"_31":11647},[],{"_33":2680,"_35":11648,"_37":1846,"_39":11649,"_63":11650,"_65":11651,"_67":66},"v16CG8Cx",{},[],"For content that is p2p synced, the client can still generate its own notifications, without connection to the notif server. So we will need a consistent mechanism to generate a notification ID.",[72],"/tech-talks/notif-rbsr",{"_84":1866},{},{"_90":1846,"_94":1864},{"_35":1843,"_102":51,"_52":11658,"_68":1846,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1845],1779255260486,[156,1843,1846,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/notif-rbsr\",\"bafy2bzaceacf3iqxz5bmf5fd3xzr4fbryu3ug22epuawe5bg6qozrurykspok\",true]",{"_117":11663,"_154":11757,"_157":11758},{"_119":11664,"_139":42,"_140":11756,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":11665,"_35":11754},{"_26":11666,"_68":1872,"_69":51,"_70":11749,"_52":11750,"_78":1879,"_80":1879,"_82":11751,"_88":11752,"_90":1872,"_92":11753,"_96":97},[11667,11674,11680,11694,11708,11722,11736],{"_29":11668,"_31":11669},[],{"_33":2680,"_35":11670,"_37":1872,"_39":11671,"_63":11672,"_65":11673,"_67":66},"jPM6LH6G",{},[],"This doc aims to explain the technical features behind the various Join/Subscribe/Follow/Notify workflows",{"_29":11675,"_31":11676},[],{"_33":2680,"_35":11677,"_37":1872,"_39":11678,"_63":11679,"_65":66,"_67":66},"nEN2zYp0",{},[],{"_29":11681,"_31":11689},[11682],{"_29":11683,"_31":11684},[],{"_33":2680,"_35":11685,"_37":1872,"_39":11686,"_63":11687,"_65":11688,"_67":66},"mGud6gjP",{},[],"Our original \"Subscribe\" in the desktop app which allows for background sync and archival of a doc or site",{"_33":3020,"_35":11690,"_37":1872,"_39":11691,"_63":11692,"_65":11693,"_67":66},"WtbZysAz",{"_2719":243},[],"Subscription Syncing",{"_29":11695,"_31":11703},[11696],{"_29":11697,"_31":11698},[],{"_33":2680,"_35":11699,"_37":1872,"_39":11700,"_63":11701,"_65":11702,"_67":66},"n4Sqp3gI",{},[],"Our existing email notifications",{"_33":3020,"_35":11704,"_37":1872,"_39":11705,"_63":11706,"_65":11707,"_67":66},"O0Mj_ZgI",{"_2719":243},[],"Anonymous Email Notifications",{"_29":11709,"_31":11717},[11710],{"_29":11711,"_31":11712},[],{"_33":2680,"_35":11713,"_37":1872,"_39":11714,"_63":11715,"_65":11716,"_67":66},"oJbZA9J3",{},[],"Used to give easy access to something in the desktop app. Not strictly related to follow/join/subscribe, but might be related or useful",{"_33":3020,"_35":11718,"_37":1872,"_39":11719,"_63":11720,"_65":11721,"_67":66},"SzzCy-mv",{"_2719":243},[],"Favorite/Bookmark",{"_29":11723,"_31":11731},[11724],{"_29":11725,"_31":11726},[],{"_33":2680,"_35":11727,"_37":1872,"_39":11728,"_63":11729,"_65":11730,"_67":66},"73AWQ7zY",{},[],"The upcoming notification workflow where an account has authenticated interaction with the notification server. Currently used for mentions and replies but will soon be used for email notifications",{"_33":3020,"_35":11732,"_37":1872,"_39":11733,"_63":11734,"_65":11735,"_67":66},"OyQpjihL",{"_2719":243},[],"Account/Synced Notification",{"_29":11737,"_31":11745},[11738],{"_29":11739,"_31":11740},[],{"_33":2680,"_35":11741,"_37":1872,"_39":11742,"_63":11743,"_65":11744,"_67":66},"k1JZhGk_",{},[],"A signed contact blob where one account publicly acknowledges another",{"_33":3020,"_35":11746,"_37":1872,"_39":11747,"_63":11748,"_65":7217,"_67":66},"WSBI89f0",{"_2719":243},[],[72],"/tech-talks/joinsubscribefollownotify",{"_84":1888},{},{"_90":1872,"_94":1886},{"_35":1869,"_102":51,"_52":11755,"_68":1872,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1871],1779255260595,[156,1869,1872,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/joinsubscribefollownotify\",\"bafy2bzacec3boggkxtxylhtxwaq6roa37kejjcvls6lmty44w2h3feac4f25g\",true]",{"_117":11760,"_154":11916,"_157":11917},{"_119":11761,"_139":42,"_140":11915,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":11762,"_35":11913},{"_26":11763,"_68":2017,"_69":51,"_70":11908,"_52":11909,"_78":2024,"_80":2024,"_82":11910,"_88":11911,"_90":2017,"_92":11912,"_96":97},[11764,11775,11786,11826,11867],{"_29":11765,"_31":11766},[],{"_33":2680,"_35":11767,"_37":2017,"_39":11768,"_63":11769,"_65":11774,"_67":66},"L-K4B5E5",{},[11770],{"_33":2751,"_2788":11771,"_2790":11772,"_39":11773,"_67":66},[2551],[491],{},"Currently we have a ?feed=true route in our web app.",{"_29":11776,"_31":11777},[],{"_33":2680,"_35":11778,"_37":2017,"_39":11779,"_63":11780,"_65":11785,"_67":66},"C9LXtCX-",{},[11781],{"_33":2751,"_2788":11782,"_2790":11783,"_39":11784,"_67":66},[2817],[8234],{},"This is inconsistent with our new URL formats such as /my-doc/:discussions",{"_29":11787,"_31":11821},[11788,11799,11810],{"_29":11789,"_31":11790},[],{"_33":2680,"_35":11791,"_37":2017,"_39":11792,"_63":11793,"_65":11798,"_67":66},"A9mFLkBN",{},[11794],{"_33":2751,"_2788":11795,"_2790":11796,"_39":11797,"_67":66},[1182],[2836],{},"Introduce a new /:feed URL format",{"_29":11800,"_31":11801},[],{"_33":2680,"_35":11802,"_37":2017,"_39":11803,"_63":11804,"_65":11809,"_67":66},"GCcM97On",{},[11805],{"_33":2751,"_2788":11806,"_2790":11807,"_39":11808,"_67":66},[2792],[6426],{},"So the site feed for this site is https://seedteamtalks.hyper.media/:feed",{"_29":11811,"_31":11812},[],{"_33":2680,"_35":11813,"_37":2017,"_39":11814,"_63":11815,"_65":11820,"_67":66},"U7sv2j1U",{},[11816],{"_33":2751,"_2788":11817,"_2790":11818,"_39":11819,"_67":66},[8688],[6850],{},"And this also opens up the possibility to open the feed for a specific page. If I want to see whats new with all projects, I open /projects/:feed",{"_33":3020,"_35":11822,"_37":2017,"_39":11823,"_63":11824,"_65":11825,"_67":66},"7xIri50P",{"_2719":243},[],"Proposal",{"_29":11827,"_31":11862},[11828,11839,11850],{"_29":11829,"_31":11830},[],{"_33":2680,"_35":11831,"_37":2017,"_39":11832,"_63":11833,"_65":11838,"_67":66},"VQt9hR9q",{},[11834],{"_33":2751,"_2788":11835,"_2790":11836,"_39":11837,"_67":66},[2920],[7518],{},"This is similar but different from the /:activity format because the activity focuses on a single document, while the feed shows you all the things that happen in the whole site or section.",{"_29":11840,"_31":11841},[],{"_33":2680,"_35":11842,"_37":2017,"_39":11843,"_63":11844,"_65":11849,"_67":66},"G7SAqmdu",{},[11845],{"_33":2751,"_2788":11846,"_2790":11847,"_39":11848,"_67":66},[3926],[6837],{},"Maybe we should consider :activity/all or something instead.",{"_29":11851,"_31":11852},[],{"_33":2680,"_35":11853,"_37":2017,"_39":11854,"_63":11855,"_65":11861,"_67":66},"sgbwhmhI",{},[11856],{"_33":2751,"_2788":11857,"_2790":11858,"_39":11860,"_67":66},[2549],[11859],217,{},"Also note that the activity page has filters such as versions or citations. This could be handled with a query param but it is probably better to handle as part of the \"panel param\" because that is sometimes a ?panel= query param, and sometimes is located after the colon in the main path, when the feature is expected to appear in the main panel",{"_33":3020,"_35":11863,"_37":2017,"_39":11864,"_63":11865,"_65":11866,"_67":66},"CWffk_YH",{"_2719":243},[],"Concerns",{"_29":11868,"_31":11903},[11869,11876,11883,11896],{"_29":11870,"_31":11871},[],{"_33":2680,"_35":11872,"_37":2017,"_39":11873,"_63":11874,"_65":11875,"_67":66},"PhuG_hve",{},[],"While writing this document I realized, I have no idea what to do.",{"_29":11877,"_31":11878},[],{"_33":2680,"_35":11879,"_37":2017,"_39":11880,"_63":11881,"_65":11882,"_67":66},"W2wlIBMG",{},[],"We have talked about moving away from the word \"feed\"",{"_29":11884,"_31":11885},[],{"_33":2680,"_35":11886,"_37":2017,"_39":11887,"_63":11888,"_65":11895,"_67":66},"xCiXc-Wg",{},[11889],{"_33":2751,"_2788":11890,"_2790":11892,"_39":11894,"_67":66},[11891],194,[11893],204,{},"But in any case, I believe its very important to have \"recursive activity\" of some kind, so a reader can see all of the recent activity within a site or a section of a site. And definitely, the ?feed=true is an inconsistency in our URL design.",{"_29":11897,"_31":11898},[],{"_33":2680,"_35":11899,"_37":2017,"_39":11900,"_63":11901,"_65":11902,"_67":66},"hEoJ-rKL",{},[],"I'm not sure the solution, but I believe we should solve this soon!\n",{"_33":3020,"_35":11904,"_37":2017,"_39":11905,"_63":11906,"_65":11907,"_67":66},"nEPmtWsI",{"_2719":243},[],"Conclusion",[72],"/tech-talks/proposal-new-feed-url-format",{"_84":2037},{},{"_90":2017,"_94":2035},{"_35":2014,"_102":51,"_52":11914,"_68":2017,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2016],1779255260609,[156,2014,2017,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/proposal-new-feed-url-format\",\"bafy2bzaceaqrtju2mrzqw2cq2h3dfmzpedak3o3qc4hdhcj36bacv74ynry6c\",true]",{"_117":11919,"_154":12260,"_157":12261},{"_119":11920,"_139":42,"_140":12259,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":11921,"_35":12257},{"_26":11922,"_68":1894,"_69":51,"_70":12252,"_52":12253,"_78":1901,"_80":1901,"_82":12254,"_88":12255,"_90":1894,"_92":12256,"_96":97},[11923,11935,11942,11959,12078,12216],{"_29":11924,"_31":11925},[],{"_33":2680,"_35":11926,"_37":1894,"_39":11927,"_63":11928,"_65":11934,"_67":66},"tmKcOAkB",{},[11929],{"_33":204,"_2788":11930,"_2790":11931,"_39":11932,"_67":11933},[1057],[2966],{},"https://catern.com/inheritance.html","Source: https://catern.com/inheritance.html",{"_29":11936,"_31":11937},[],{"_33":2680,"_35":11938,"_37":1894,"_39":11939,"_63":11940,"_65":11941,"_67":66},"BsqVpgLM",{},[],"Inheritance was invented by the Simula language as a way to support intrusive lists, save memory, and simplify the garbage collector.",{"_29":11943,"_31":11944},[],{"_33":2680,"_35":11945,"_37":1894,"_39":11946,"_63":11947,"_65":11958,"_67":66},"NHjkSqmJ",{},[11948,11953],{"_33":204,"_2788":11949,"_2790":11950,"_39":11951,"_67":11952},[2907],[2853],{},"https://en.wikipedia.org/wiki/Inheritance_(object-oriented_programming)",{"_33":204,"_2788":11954,"_2790":11955,"_39":11956,"_67":11957},[8079],[7717],{},"https://www.cs.tufts.edu/comp/150FP/archive/kristen-nygaard/hopl-simula.pdf","It's well known that inheritance was invented by Simula. The History of Programming Languages session on Simula tells us the motivations behind that invention. Let's take a look.",{"_29":11960,"_31":12073},[11961,11973,11999,12023,12030,12037,12062],{"_29":11962,"_31":11963},[],{"_33":2680,"_35":11964,"_37":1894,"_39":11965,"_63":11966,"_65":11972,"_67":66},"CBjixxqK",{},[11967],{"_33":204,"_2788":11968,"_2790":11969,"_39":11970,"_67":11971},[2878],[2853],{},"https://en.wikipedia.org/wiki/Composition_over_inheritance","Simula created inheritance instead of using composition because it allowed their garbage collector to be simpler.",{"_29":11974,"_31":11993},[11975,11982],{"_29":11976,"_31":11977},[],{"_33":2680,"_35":11978,"_37":1894,"_39":11979,"_63":11980,"_65":11981,"_67":66},"x6KoAEss",{},[],"Unable to find such a [manual memory allocation] scheme providing sufficient programming flexibility, we implemented a reference count scheme, an idea borrowed from Weizenbaum (1962), and also added a \"last resort\" garbage collector.",{"_29":11983,"_31":11984},[],{"_33":2680,"_35":11985,"_37":1894,"_39":11986,"_63":11987,"_65":11992,"_67":66},"3M2g7Ywc",{},[11988],{"_33":204,"_2788":11989,"_2790":11990,"_39":11991,"_67":11957},[2821],[6287],{},"– Section 2.3.3, The Development Of The Simula Languages",{"_33":2680,"_35":11994,"_37":1894,"_39":11995,"_63":11997,"_65":11998,"_67":66},"vlxaE9To",{"_2719":11996},"Blockquote",[],"Simula had a simple reference counting and garbage collection implementation:",{"_29":12000,"_31":12018},[12001],{"_29":12002,"_31":12013},[12003],{"_29":12004,"_31":12005},[],{"_33":2680,"_35":12006,"_37":1894,"_39":12007,"_63":12008,"_65":11992,"_67":66},"3mHzlp4b",{},[12009],{"_33":204,"_2788":12010,"_2790":12011,"_39":12012,"_67":11957},[2821],[6287],{},{"_33":2680,"_35":12014,"_37":1894,"_39":12015,"_63":12016,"_65":12017,"_67":66},"JFLAseWB",{"_2719":243},[],"A process could outlive its dynamic parent, i.e., the block instance containing the generating expression which gave rise to the process. As a result the process might access nonexisting data through its formal parameters. The remedy chosen was to forbid all kinds of call by name parameters to processes (including procedures, labels, and switches).",{"_33":2680,"_35":12019,"_37":1894,"_39":12020,"_63":12021,"_65":12022,"_67":66},"IVY1CYxH",{"_2719":11996},[],"Using reference counting and garbage collection is fine and good, but their GC was a little too simple:",{"_29":12024,"_31":12025},[],{"_33":2680,"_35":12026,"_37":1894,"_39":12027,"_63":12028,"_65":12029,"_67":66},"qS33bRX0",{},[],"The problem is that one can store a pointer to a stack-allocated variable inside of an object (\"process\", in Simula terminology), then return that object from the scope of that variable, so the stack frame storing the variable is deallocated. That will make later use of that object unsafe: \"the process might access nonexisting data\".",{"_29":12031,"_31":12032},[],{"_33":2680,"_35":12033,"_37":1894,"_39":12034,"_63":12035,"_65":12036,"_67":66},"y5xIzdJ1",{},[],"With more sophisticated garbage collectors, such as the ones used in Lisp even at the time, this is not an issue.",{"_29":12038,"_31":12057},[12039,12046],{"_29":12040,"_31":12041},[],{"_33":2680,"_35":12042,"_37":1894,"_39":12043,"_63":12044,"_65":12045,"_67":66},"vkRvP9ti",{},[],"When writing simulation programs we had observed that processes often shared a number of common properties, both in data attributes and actions, but were structurally different in other respects so that they had to be described by separate declarations. [...] Parametrization could not provide enough flexibility, especially since parameters called by name, including procedure parameters, had been banned for processes (for good reasons, see Section 2.3.3).",{"_29":12047,"_31":12048},[],{"_33":2680,"_35":12049,"_37":1894,"_39":12050,"_63":12051,"_65":12056,"_67":66},"qpVSzdTq",{},[12052],{"_33":204,"_2788":12053,"_2790":12054,"_39":12055,"_67":11957},[2087],[2817],{},"– Section 3.1, The Development Of The Simula Languages",{"_33":2680,"_35":12058,"_37":1894,"_39":12059,"_63":12060,"_65":12061,"_67":66},"UQXQytAt",{"_2719":11996},[],"The simple GC implementation in Simula solved this problem and others by banning passing many things as arguments, including passing functions as arguments. In a sense, they removed the support for first-class functions which existed in ALGOL 60, which Simula was an extension of. Predictably, this reduced the expressivity of the language:",{"_29":12063,"_31":12064},[],{"_33":2680,"_35":12065,"_37":1894,"_39":12066,"_63":12067,"_65":12072,"_67":66},"KR2QBelH",{},[12068],{"_33":204,"_2788":12069,"_2790":12070,"_39":12071,"_67":11971},[7521],[7724],{},"As a result of the limitations of their GC, they weren't able to use \"parametrization\" (what we'd call composition) to customize classes. Instead, they had to invent inheritance.",{"_33":3020,"_35":12074,"_37":1894,"_39":12075,"_63":12076,"_65":12077,"_67":66},"9c0PIKxl",{"_2719":243},[],"Simplifying the garbage collector",{"_29":12079,"_31":12211},[12080,12092,12117,12124,12148,12159,12197,12204],{"_29":12081,"_31":12082},[],{"_33":2680,"_35":12083,"_37":1894,"_39":12084,"_63":12085,"_65":12091,"_67":66},"7qWSIQqy",{},[12086],{"_33":204,"_2788":12087,"_2790":12088,"_39":12089,"_67":12090},[6386],[8236],{},"https://stackoverflow.com/questions/3361145/intrusive-lists","Simula's direct inspiration for inheritance was to simplify the usage ofintrusive lists, a clever hack still used today which makes linked lists more efficient, though less flexible.",{"_29":12093,"_31":12112},[12094,12101],{"_29":12095,"_31":12096},[],{"_33":2680,"_35":12097,"_37":1894,"_39":12098,"_63":12099,"_65":12100,"_67":66},"gqMQmc0a",{},[],"In retrospect the introduction of \"multimembership\" sets was a mistake. First the \"sets\" were really process sequences allowing multiple process occurrences, whereas simple process chains would have been more appropriate for most purposes. [...] There was an ever-present overhead in process referencing caused by the fact that all process pointers were directed through separately allocated \"element\" objects.",{"_29":12102,"_31":12103},[],{"_33":2680,"_35":12104,"_37":1894,"_39":12105,"_63":12106,"_65":12111,"_67":66},"DnRRsypQ",{},[12107],{"_33":204,"_2788":12108,"_2790":12109,"_39":12110,"_67":11957},[2821],[6287],{},"– Section 2.3.4, The Development Of The Simula Languages",{"_33":2680,"_35":12113,"_37":1894,"_39":12114,"_63":12115,"_65":12116,"_67":66},"NebJzYiV",{"_2719":11996},[],"In the first version of Simula, before they invented inheritance and other OOP features, they supported a data structure called \"sets\", which were arbitrary linked lists of objects (\"processes\", in Simula terminology):",{"_29":12118,"_31":12119},[],{"_33":2680,"_35":12120,"_37":1894,"_39":12121,"_63":12122,"_65":12123,"_67":66},"5xxCpzDb",{},[],"As usual for a traditional linked list, the linked list nodes (called \"elements\" in the quote) were separately allocated, increasing memory usage and causing memory fragmentation. In comparison, in an intrusive list, the list nodes are not separately allocated.",{"_29":12125,"_31":12143},[12126,12133],{"_29":12127,"_31":12128},[],{"_33":2680,"_35":12129,"_37":1894,"_39":12130,"_63":12131,"_65":12132,"_67":66},"Smr89xRM",{},[],"The element/set concepts were too clumsy as basic, general purpose mechanisms for list processing. Even for simulation modeling our experience showed that simple process pointers might be better, combined with an inherent set membership capability of processes, restricted to one set at a time.",{"_29":12134,"_31":12135},[],{"_33":2680,"_35":12136,"_37":1894,"_39":12137,"_63":12138,"_65":12056,"_67":66},"lh1VUb2A",{},[12139],{"_33":204,"_2788":12140,"_2790":12141,"_39":12142,"_67":11957},[2087],[2817],{},{"_33":2680,"_35":12144,"_37":1894,"_39":12145,"_63":12146,"_65":12147,"_67":66},"DNF1cD3l",{"_2719":11996},[],"In later versions of Simula, they decided that a simpler data structure which didn't allow an object to be in multiple linked lists, and which didn't require inefficient \"element\" objects, would be better:",{"_29":12149,"_31":12150},[],{"_33":2680,"_35":12151,"_37":1894,"_39":12152,"_63":12153,"_65":12158,"_67":66},"npurTvl8",{},[12154],{"_33":204,"_2788":12155,"_2790":12156,"_39":12157,"_67":12090},[2793],[8234],{},"They decided to replace their traditional linked lists withintrusive lists, which are much more memory-efficient and time-efficient than traditional linked lists.",{"_29":12160,"_31":12192},[12161,12168,12175,12182],{"_29":12162,"_31":12163},[],{"_33":2680,"_35":12164,"_37":1894,"_39":12165,"_63":12166,"_65":12167,"_67":66},"Ln9aHVkH",{},[],"The solution came suddenly, with the idea of \"prefixing,\" in December 1966. We were thinking in terms of a toll booth on a bridge, with a queue of cars which were either trucks or buses. (This example reappears in Dahl and Nygaard, 1968.) A \"stripped\" list structure, consisting of a \"set head\" and a variable number of \"links,\" had been written down, when we saw that both our problems could be solved by a mechanism for \"gluing\" each of the various processes (trucks, buses) on to a \"link\" to make each link-process pair one block instance.",{"_29":12169,"_31":12170},[],{"_33":2680,"_35":12171,"_37":1894,"_39":12172,"_63":12173,"_65":12174,"_67":66},"JdnYTd30",{},[],"[...]",{"_29":12176,"_31":12177},[],{"_33":2680,"_35":12178,"_37":1894,"_39":12179,"_63":12180,"_65":12181,"_67":66},"aKgsbqw-",{},[],"Usually a new idea was subjected to rather violent attacks in order to test its strength. The prefix idea was the only exception. We immediately realized that we now had the necessary foundation for a completely new language approach.",{"_29":12183,"_31":12184},[],{"_33":2680,"_35":12185,"_37":1894,"_39":12186,"_63":12187,"_65":12056,"_67":66},"sTiORIYH",{},[12188],{"_33":204,"_2788":12189,"_2790":12190,"_39":12191,"_67":11957},[2087],[2817],{},{"_33":2680,"_35":12193,"_37":1894,"_39":12194,"_63":12195,"_65":12196,"_67":66},"-z8k_4hY",{"_2719":11996},[],"However, intrusive lists require that the linked list node be part of the definition of the class that will be on the list. Traditional composition techniques would be insufficient for this, even if they were available in Simula. The Simula authors didn't know how they'd implement it, until:",{"_29":12198,"_31":12199},[],{"_33":2680,"_35":12200,"_37":1894,"_39":12201,"_63":12202,"_65":12203,"_67":66},"xeaqdkyk",{},[],"In Simula, inheritence was called \"prefixing\"; a base class is a \"prefix\".",{"_29":12205,"_31":12206},[],{"_33":2680,"_35":12207,"_37":1894,"_39":12208,"_63":12209,"_65":12210,"_67":66},"lkn0ldm4",{},[],"So the idea of inheritance originated in the idea of implementing an intrusive list by having objects inherit from the intrusive list node, the \"link\". In this way, intrusive lists, an otherwise complex performance hack, could be easily used.",{"_33":3020,"_35":12212,"_37":1894,"_39":12213,"_63":12214,"_65":12215,"_67":66},"eHTkjGij",{"_2719":243},[],"Supporting intrusive lists",{"_29":12217,"_31":12248},[12218,12225,12232],{"_29":12219,"_31":12220},[],{"_33":2680,"_35":12221,"_37":1894,"_39":12222,"_63":12223,"_65":12224,"_67":66},"RH97E0np",{},[],"It's certainly not bad to create features for performance reasons. And of course, Simula was genius in many other ways. They invented practically every part of modern OOP, not just inheritance; and their use of ubiquitous concurrency in objects is a particularly cool feature that should be copied more.",{"_29":12226,"_31":12227},[],{"_33":2680,"_35":12228,"_37":1894,"_39":12229,"_63":12230,"_65":12231,"_67":66},"bCPd0NRR",{},[],"But it's interesting that no-one today ever talks about inheritance as a performance feature. They talk about the code reuse and extensibility benefits.",{"_29":12233,"_31":12234},[],{"_33":2680,"_35":12235,"_37":1894,"_39":12236,"_63":12237,"_65":12247,"_67":66},"AoleE6BO",{},[12238,12242],{"_33":204,"_2788":12239,"_2790":12240,"_39":12241,"_67":11971},[2853],[2837],{},{"_33":204,"_2788":12243,"_2790":12244,"_39":12245,"_67":12246},[6790],[2891],{},"https://en.wikipedia.org/wiki/Standard_ML#Module_system","Personally, for code reuse and extensibility, I prefer composition and modules.",{"_33":3020,"_35":12249,"_37":1894,"_39":12250,"_63":12251,"_65":11907,"_67":66},"CwLgrpEr",{"_2719":243},[],[75],"/tech-talks/inheritance-was-invented-as-a-performance-hack",{"_84":1914},{},{"_90":1894,"_94":1912},{"_35":1891,"_102":51,"_52":12258,"_68":1894,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1893],1779255260596,[156,1891,1894,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/inheritance-was-invented-as-a-performance-hack\",\"bafy2bzacebvmjwa6blv2ol2o6kinjhprlpla2hbv2l43tbvbfhxezcgtsyseo\",true]",{"_117":12263,"_154":12283,"_157":12284},{"_119":12264,"_139":42,"_140":12282,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":12265,"_35":12280},{"_26":12266,"_68":1920,"_69":51,"_70":12275,"_52":12276,"_78":1926,"_80":1926,"_82":12277,"_88":12278,"_90":1920,"_92":12279,"_96":97},[12267],{"_29":12268,"_31":12269},[],{"_33":12270,"_35":12271,"_37":1920,"_39":12272,"_63":12273,"_65":66,"_67":12274},"WebEmbed","EaWPsgrS",{},[],"https://x.com/JohannesMutter/status/2023931011046732004?s=20",[75],"/tech-talks/interface-linage",{"_84":1935},{},{"_90":1920,"_94":1933},{"_35":1917,"_102":51,"_52":12281,"_68":1920,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1919],1779255260585,[156,1917,1920,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/interface-linage\",\"bafy2bzaceclhzdlz3babhlsizutkunvo3tiwiywvxvfmbolwi46uf6sl2l2my\",true]",{"_117":12286,"_154":12312,"_157":12313},{"_119":12287,"_139":42,"_140":12311,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":12288,"_35":12309},{"_26":12289,"_68":1966,"_69":51,"_70":12304,"_52":12305,"_78":1973,"_80":1973,"_82":12306,"_88":12307,"_90":1966,"_92":12308,"_96":97},[12290],{"_29":12291,"_31":12299},[12292],{"_29":12293,"_31":12294},[],{"_33":6334,"_35":12295,"_37":1966,"_39":12296,"_63":12297,"_65":66,"_67":12298},"tB9fMN_Q",{"_2719":243},[],"ipfs://bafkreidv6vftnvqz73jhqef6rhbuwf2mxk5cp26flp2ynz7vopt7pv4w5q",{"_33":2680,"_35":12300,"_37":1966,"_39":12301,"_63":12302,"_65":12303,"_67":66},"S87YUZnY",{"_2719":243},[],"If you instruct an agent to read a seed hypermedia web I would be nice that also read the discussions section as many of the knowledge is buried in comments. This is the kind of specific knowledge that has to be written in a SKILL IMO. But, regardless, if i instruct the agent to go straight to a discussions section then it cant read it. Is there any architecture decision we need to revisit?",[73],"/tech-talks/read-discussions-programatically",{"_84":1986},{},{"_90":1966,"_94":1984},{"_35":1963,"_102":51,"_52":12310,"_68":1966,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1965],1779255260578,[156,1963,1966,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/read-discussions-programatically\",\"bafy2bzacealurzn3z5kr6ov2mlz4wdnr3tuemmbsacjygldv5fm2bled4vi7o\",true]",{"_117":12315,"_154":12578,"_157":12579},{"_119":12316,"_139":42,"_140":12577,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":12317,"_35":12575},{"_26":12318,"_68":1941,"_69":51,"_70":12569,"_52":12570,"_78":1950,"_80":12571,"_82":12572,"_88":12573,"_90":1951,"_92":12574,"_96":97},[12319,12435,12484,12537],{"_29":12320,"_31":12430},[12321],{"_29":12322,"_31":12425},[12323,12355,12376,12411],{"_29":12324,"_31":12350},[12325,12343],{"_29":12326,"_31":12327},[],{"_33":2680,"_35":12328,"_37":1951,"_39":12329,"_63":12330,"_65":12342,"_67":66},"3LxY1YqN",{},[12331,12336],{"_33":204,"_2788":12332,"_2790":12333,"_39":12334,"_67":12335},[6369],[6848],{},"hm://z6MkfzKMhF9k1oPaQsShWAg8xJzbWf5kaZgn1MkeZvhcAsmB/data?v=bafy2bzacedcc6hpqrlafaeoopzeqkv6gw2afjxuo2aygcden7r7xmvikvsirs&l",{"_33":204,"_2788":12337,"_2790":12338,"_39":12340,"_67":12341},[7537],[12339],207,{},"hm://z6MkfzKMhF9k1oPaQsShWAg8xJzbWf5kaZgn1MkeZvhcAsmB/interfaces/p2p-api?v=bafy2bzacearjhraec6sxlrl426zjtawdsturycg4tnv6x4gzqelsrjhuktcz2&l","For the protocol to gain adoption, developers need to understand the data that gets signed and distributed. And we also need to understand and document the RPCs that are used to communicate between p2p nodes, and what RPCs a single node may expose to its consumers (GUIs, APIs, command lines, agentic access)",{"_29":12344,"_31":12345},[],{"_33":2680,"_35":12346,"_37":1951,"_39":12347,"_63":12348,"_65":12349,"_67":66},"1EuabWsh",{},[],"I suggest a unified system to describe both the verifiable signed data and the APIs, because they have overlapping schemas. For example the \"block type\" which describes chunks of content like paragraphs and images in a document. This type is useful to describe both the node RPCs, and to describe the format of the verifiable signed data.",{"_33":3020,"_35":12351,"_37":1951,"_39":12352,"_63":12353,"_65":12354,"_67":66},"HmME35mT",{"_2719":243},[],"People need to Understand Hypermedia Protocol",{"_29":12356,"_31":12371},[12357,12364],{"_29":12358,"_31":12359},[],{"_33":2680,"_35":12360,"_37":1951,"_39":12361,"_63":12362,"_65":12363,"_67":66},"ENT-b0Gk",{},[],"There are many use cases which the core team cannot support, or does not want to impose on the community. For example if someone in the community wants to experiment with a new form of media like interactive video, they should be able to write software that interacts with the network safely, not breaking other software.",{"_29":12365,"_31":12366},[],{"_33":2680,"_35":12367,"_37":1951,"_39":12368,"_63":12369,"_65":12370,"_67":66},"cvkl-oKc",{},[],"And on the core team, we may want to develop our own experiments and internal tools, while keeping the core documents+comments functionality of the protocol stable.",{"_33":3020,"_35":12372,"_37":1951,"_39":12373,"_63":12374,"_65":12375,"_67":66},"FJHuB6we",{"_2719":243},[],"The Hypermedia Protocol Must be Extensible",{"_29":12377,"_31":12406},[12378,12385,12392,12399],{"_29":12379,"_31":12380},[],{"_33":2680,"_35":12381,"_37":1951,"_39":12382,"_63":12383,"_65":12384,"_67":66},"KcCBHT0Q",{},[],"With a formal schema, we can deliver some useful tools. For example, we could build a GUI that allows us to safely experiment with the raw RPCs and data.",{"_29":12386,"_31":12387},[],{"_33":2680,"_35":12388,"_37":1951,"_39":12389,"_63":12390,"_65":12391,"_67":66},"ADFFDk8m",{},[],"In the signed verifiable data, for example, an IPFS file URL may be encoded as a string (or a raw IPLD CID). But when we expose that to the user, we can offer a file picker. If the schema implies that this should be an image, we can display the image and make sure the user does not select a zip file.",{"_29":12393,"_31":12394},[],{"_33":2680,"_35":12395,"_37":1951,"_39":12396,"_63":12397,"_65":12398,"_67":66},"H7abl8pX",{},[],"Another useful application of a robust schema system is automatically creating type-safe SDKs in many languages, lowering the barrier to entry for developers in different ecosystems to participate in the same data universe.",{"_29":12400,"_31":12401},[],{"_33":2680,"_35":12402,"_37":1951,"_39":12403,"_63":12404,"_65":12405,"_67":66},"wI_GSAoK",{},[],"Also, our APIs may be more robust with a schema system. When a user sends data to an API, we can validate it against schemas and provide detailed errors, telling the user what they did incorrectly.",{"_33":3020,"_35":12407,"_37":1951,"_39":12408,"_63":12409,"_65":12410,"_67":66},"LKr8ygxd",{"_2719":243},[],"Programatic Access to Data and RPCs",{"_29":12412,"_31":12420},[12413],{"_29":12414,"_31":12415},[],{"_33":2680,"_35":12416,"_37":1951,"_39":12417,"_63":12418,"_65":12419,"_67":66},"7g-6dqoM",{},[],"Currently the \"verification\" of the verifiable data simply checks for the signatures and permissions/capabilities of the writer to ensure they are allowed to edit the resource. It does not validate the structural integrity of a resource. For example if a user uploads arbitrary data inside the content of a comment, the system will accept that comment even if it is nonsensical, and the UI will break as a result.",{"_33":3020,"_35":12421,"_37":1951,"_39":12422,"_63":12423,"_65":12424,"_67":66},"_-Srxyx_",{"_2719":243},[],"Protocol Robustness",{"_33":2680,"_35":12426,"_37":1941,"_39":12427,"_63":12428,"_65":12429,"_67":66},"kJAQrRc7",{"_2719":243},[],"We aim to solve a few problems:",{"_33":3020,"_35":12431,"_37":1951,"_39":12432,"_63":12433,"_65":12434,"_67":66},"5Qven48l",{"_2719":243},[],"Problems",{"_29":12436,"_31":12479},[12437,12451,12465],{"_29":12438,"_31":12446},[12439],{"_29":12440,"_31":12441},[],{"_33":2680,"_35":12442,"_37":1951,"_39":12443,"_63":12444,"_65":12445,"_67":66},"VTkBfBkE",{},[],"We have existing data in our system, (DAG-CBOR encoded) which has been signed and then referenced in chains of data. This is basically impossible to change, so we are locked in to certain decisions. The solution is to add a schema system on top of the existing data. New data may reference a schema, and old data will have a fallback schema which matches our current data formats.",{"_33":3020,"_35":12447,"_37":1951,"_39":12448,"_63":12449,"_65":12450,"_67":66},"ZexSDrvQ",{"_2719":243},[],"Support Existing Data",{"_29":12452,"_31":12460},[12453],{"_29":12454,"_31":12455},[],{"_33":2680,"_35":12456,"_37":1951,"_39":12457,"_63":12458,"_65":12459,"_67":66},"kbuyNeXn",{},[],"There must be a system where the data formats can safely evolve, without breaking older software, or software that partially supports the schema.",{"_33":3020,"_35":12461,"_37":1951,"_39":12462,"_63":12463,"_65":12464,"_67":66},"oc_NlDlC",{"_2719":243},[],"Evolution, Partial Compatibility",{"_29":12466,"_31":12474},[12467],{"_29":12468,"_31":12469},[],{"_33":2680,"_35":12470,"_37":1951,"_39":12471,"_63":12472,"_65":12473,"_67":66},"APPZI2Hb",{},[],"Ideally, the community can openly build upon schemas from others in the community. For example, one member of the community might develop a \"livestreaming\" resource, and somebody else could create a more detailed schema which extends it, augmenting with some features. The augmented livestreams must still be usable by the original livestream application. We should not rely on the core team to unlock safe collaboration of new data types in the protocol.",{"_33":3020,"_35":12475,"_37":1951,"_39":12476,"_63":12477,"_65":12478,"_67":66},"Z8-XF9Y0",{"_2719":243},[],"Extendability",{"_33":3020,"_35":12480,"_37":1951,"_39":12481,"_63":12482,"_65":12483,"_67":66},"HjG8xmE6",{"_2719":243},[],"Design Constraints",{"_29":12485,"_31":12533},[12486],{"_29":12487,"_31":12528},[12488,12495,12502,12509,12515,12522],{"_29":12489,"_31":12490},[],{"_33":2680,"_35":12491,"_37":1951,"_39":12492,"_63":12493,"_65":12494,"_67":66},"I7CNtcxy",{},[],"RDF and RDF schema",{"_29":12496,"_31":12497},[],{"_33":2680,"_35":12498,"_37":1951,"_39":12499,"_63":12500,"_65":12501,"_67":66},"QM7K1n43",{},[],"XRPC Lexicons",{"_29":12503,"_31":12504},[],{"_33":2680,"_35":12505,"_37":1951,"_39":12506,"_63":12507,"_65":12508,"_67":66},"JBsG01PA",{},[],"JSON Schema",{"_29":12510,"_31":12511},[],{"_33":2680,"_35":12512,"_37":1951,"_39":12513,"_63":12514,"_65":9543,"_67":66},"NvNFgR_q",{},[],{"_29":12516,"_31":12517},[],{"_33":2680,"_35":12518,"_37":1951,"_39":12519,"_63":12520,"_65":12521,"_67":66},"yWbsfggN",{},[],"protocol buffers",{"_29":12523,"_31":12524},[],{"_33":2680,"_35":12525,"_37":1951,"_39":12526,"_63":12527,"_65":9550,"_67":66},"h06lbW5c",{},[],{"_33":2680,"_35":12529,"_37":1951,"_39":12530,"_63":12531,"_65":12532,"_67":66},"nzePSKPq",{"_2719":2972},[],"Largely undecided! Some things to explore:",{"_33":3020,"_35":12534,"_37":1951,"_39":12535,"_63":12536,"_65":9476,"_67":66},"eteZb5Wm",{"_2719":243},[],{"_29":12538,"_31":12564},[12539,12551],{"_29":12540,"_31":12541},[],{"_33":2680,"_35":12542,"_37":1951,"_39":12543,"_63":12544,"_65":12550,"_67":66},"2eaMdoGK",{},[12545],{"_33":204,"_2788":12546,"_2790":12547,"_39":12548,"_67":12549},[2905],[8079],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/discussions/unified-protocol-types#g1wOXUWA[180:197]","We had a document from last year which discussed this problem. And some others which I can't easily find.",{"_29":12552,"_31":12553},[],{"_33":2680,"_35":12554,"_37":12555,"_39":12556,"_63":12557,"_65":12563,"_67":66},"abT-FPNA","bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg",{},[12558],{"_33":2727,"_2788":12559,"_2790":12560,"_39":12561,"_67":12562},[144],[42],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/academic-papers/haystack-a-platform-for-creating-organizing-and-visualizing-information-using-rdf"," ",{"_33":3020,"_35":12565,"_37":1951,"_39":12566,"_63":12567,"_65":12568,"_67":66},"k9a2oqYa",{"_2719":2972},[],"Notes and References",[72,75],"/tech-talks/hypermedia-protocol-schemas","2026-02-15T16:19:20.758Z",{"_84":1960},{},{"_90":1951,"_94":1958},{"_35":1938,"_102":51,"_52":12576,"_68":1941,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,1940],1779255260589,[156,1938,1941,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas\",\"bafy2bzaceasybr2tdicr7r3775qd4i32pn7gopibtlfg2b5x7s6ad2ihmpqis\",true]",{"_117":12581,"_154":12740,"_157":12741},{"_119":12582,"_139":42,"_140":12739,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":12583,"_35":12737},{"_26":12584,"_68":2043,"_69":51,"_70":12732,"_52":12733,"_78":2050,"_80":2050,"_82":12734,"_88":12735,"_90":2043,"_92":12736,"_96":97},[12585,12592],{"_29":12586,"_31":12587},[],{"_33":2680,"_35":12588,"_37":2043,"_39":12589,"_63":12590,"_65":12591,"_67":66},"XnP5dKBl",{},[],"Get up and running with the dev environment",{"_29":12593,"_31":12727},[12594,12613,12655,12698],{"_29":12595,"_31":12608},[12596],{"_29":12597,"_31":12598},[],{"_33":2680,"_35":12599,"_37":2043,"_39":12600,"_63":12601,"_65":12607,"_67":66},"y2u6EOqJ",{},[12602],{"_33":204,"_2788":12603,"_2790":12604,"_39":12605,"_67":12606},[7703],[2878],{},"https://brew.sh/","First, make sure you have homebrew installed to help you get the required software.",{"_33":3020,"_35":12609,"_37":2043,"_39":12610,"_63":12611,"_65":12612,"_67":66},"ZEC9zk2-",{"_2719":243},[],"1. Homebrew",{"_29":12614,"_31":12650},[12615,12622],{"_29":12616,"_31":12617},[],{"_33":2751,"_35":12618,"_37":2043,"_39":12619,"_63":12620,"_65":12621,"_67":66},"9DlEGi1Q",{"_2753":66},[],"brew install direnv yarn mise",{"_29":12623,"_31":12645},[12624,12631,12638],{"_29":12625,"_31":12626},[],{"_33":2680,"_35":12627,"_37":2043,"_39":12628,"_63":12629,"_65":12630,"_67":66},"4ftIlvm4",{},[],"Mise - manages native dependencies",{"_29":12632,"_31":12633},[],{"_33":2680,"_35":12634,"_37":2043,"_39":12635,"_63":12636,"_65":12637,"_67":66},"axpTPLq-",{},[],"Direnv - sets up your local shell environment",{"_29":12639,"_31":12640},[],{"_33":2680,"_35":12641,"_37":2043,"_39":12642,"_63":12643,"_65":12644,"_67":66},"42BKUtsv",{},[],"Yarn - used for frontend installs and tasks",{"_33":2680,"_35":12646,"_37":2043,"_39":12647,"_63":12648,"_65":12649,"_67":66},"fZo04VoO",{"_2719":2972},[],"Currently we require these to be installed.",{"_33":3020,"_35":12651,"_37":2043,"_39":12652,"_63":12653,"_65":12654,"_67":66},"FWG6x4Jk",{"_2719":243},[],"2. Yarn, Direnv, Mise",{"_29":12656,"_31":12693},[12657,12664,12675,12682],{"_29":12658,"_31":12659},[],{"_33":2680,"_35":12660,"_37":2043,"_39":12661,"_63":12662,"_65":12663,"_67":66},"TqkgTTmA",{},[],"To run desktop in dev mode:",{"_29":12665,"_31":12666},[],{"_33":2680,"_35":12667,"_37":2043,"_39":12668,"_63":12669,"_65":12674,"_67":66},"dQ7UXIOZ",{},[12670],{"_33":2751,"_2788":12671,"_2790":12672,"_39":12673,"_67":66},[144],[2821],{},"./dev run-desktop ",{"_29":12676,"_31":12677},[],{"_33":2680,"_35":12678,"_37":2043,"_39":12679,"_63":12680,"_65":12681,"_67":66},"jSzsTChp",{},[],"For a production build:",{"_29":12683,"_31":12684},[],{"_33":2680,"_35":12685,"_37":2043,"_39":12686,"_63":12687,"_65":12692,"_67":66},"-5JQLJdI",{},[12688],{"_33":2751,"_2788":12689,"_2790":12690,"_39":12691,"_67":66},[144],[2839],{},"./dev build-desktop",{"_33":3020,"_35":12694,"_37":2043,"_39":12695,"_63":12696,"_65":12697,"_67":66},"627GIvl-",{"_2719":243},[],"3. Desktop Dev",{"_29":12699,"_31":12722},[12700,12711],{"_29":12701,"_31":12702},[],{"_33":2680,"_35":12703,"_37":2043,"_39":12704,"_63":12705,"_65":12710,"_67":66},"KKZJf7Pp",{},[12706],{"_33":2751,"_2788":12707,"_2790":12708,"_39":12709,"_67":66},[6695],[439],{},"First, install dependencies with yarn",{"_29":12712,"_31":12713},[],{"_33":2680,"_35":12714,"_37":2043,"_39":12715,"_63":12716,"_65":12721,"_67":66},"Ut7TFr9z",{},[12717],{"_33":2751,"_2788":12718,"_2790":12719,"_39":12720,"_67":66},[7514],[6695],{},"Then, run yarn web:dev:standalone",{"_33":3020,"_35":12723,"_37":2043,"_39":12724,"_63":12725,"_65":12726,"_67":66},"cvhEnHmh",{"_2719":243},[],"4. Web Dev",{"_33":3020,"_35":12728,"_37":2043,"_39":12729,"_63":12730,"_65":12731,"_67":66},"GD6t1Q1e",{"_2719":243},[],"MacOS",[72],"/tech-talks/dev-machine-setup",{"_84":2063},{},{"_90":2043,"_94":2061},{"_35":2040,"_102":51,"_52":12738,"_68":2043,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2042],1779255260531,[156,2040,2043,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/dev-machine-setup\",\"bafy2bzaceb2ulgeaa6xsnwlodgdpo4rk42exxagzkfospnpay32z2d3ilspiw\",true]",{"_117":12743,"_154":13092,"_157":13093},{"_119":12744,"_139":42,"_140":13091,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":12745,"_35":13089},{"_26":12746,"_68":2069,"_69":51,"_70":13083,"_52":13084,"_78":2077,"_80":13085,"_82":13086,"_88":13087,"_90":2078,"_92":13088,"_96":97},[12747,12814,12872,12940,13017],{"_29":12748,"_31":12810},[12749,12756,12768,12783,12796,12803],{"_29":12750,"_31":12751},[],{"_33":2680,"_35":12752,"_37":2078,"_39":12753,"_63":12754,"_65":12755,"_67":66},"rlu-MM8W",{},[],"When we first integrated electron-trpc into our Electron desktop application, the promise was compelling: end-to-end type safety, a single source of truth for our API layer, and the developer experience benefits of autocomplete and automatic refactoring. What we didn't anticipate was the performance tax we'd be paying at runtime—a cost our users bear every time they launch the application.",{"_29":12757,"_31":12758},[],{"_33":2680,"_35":12759,"_37":2078,"_39":12760,"_63":12761,"_65":12767,"_67":66},"P1K-EUgc",{},[12762],{"_33":2751,"_2788":12763,"_2790":12764,"_39":12766,"_67":66},[9692],[12765],175,{},"The reality is clear. Our current implementation forces every data access through a seven-layer abstraction stack: from UI components through the tRPC client, into the ipcLink adapter, across Electron's IPC boundary, through the main process IPC handler, into the router, and finally to the procedure implementation. Compare this to standard Electron IPC, which requires only three layers: component to contextBridge API to IPC handler. We're paying a 133% complexity tax for type safety that exists only during development.",{"_29":12769,"_31":12770},[],{"_33":2680,"_35":12771,"_37":2078,"_39":12772,"_63":12773,"_65":12782,"_67":66},"dtRXYnh0",{},[12774],{"_33":2751,"_2788":12775,"_2790":12778,"_39":12781,"_67":66},[12776,12777],269,288,[12779,12780],284,310,{},"The numbers tell a sobering story. I analyzed our codebase and found 109 tRPC procedures across 26 modules, totaling 3,615 lines of code—roughly 40% of our entire desktop application codebase. Of these 109 procedures, 42 are simple getters and setters: operations like getSetting(key) or setFavorite(id, value). These trivial operations gain nothing from tRPC's sophisticated machinery, yet they still pay the full cost of serialization, deserialization, router traversal, and type inference at runtime.",{"_29":12784,"_31":12785},[],{"_33":2680,"_35":12786,"_37":2078,"_39":12787,"_63":12788,"_65":12795,"_67":66},"uHzo1lTK",{},[12789],{"_33":3084,"_2788":12790,"_2790":12792,"_39":12794,"_67":66},[12791],558,[12793],587,{},"The bundle size impact is measurable: 28KB of additional JavaScript (tRPC client, SuperJSON transformer, and electron-trpc itself) that gets parsed and evaluated during startup. But the real performance killer isn't the bundle size—it's the runtime overhead. Every single call requires SuperJSON to serialize the request, send it across IPC, deserialize on the main process side, traverse the router tree, execute the procedure, serialize the response, send it back across IPC, and deserialize again. For a simple getter that returns a boolean, this is like using a shotgun to kill a fly.",{"_29":12797,"_31":12798},[],{"_33":2680,"_35":12799,"_37":2078,"_39":12800,"_63":12801,"_65":12802,"_67":66},"k4hzQ42T",{},[],"Perhaps most troubling is what we discovered about our startup sequence. Because all 26 tRPC modules are eagerly loaded at application start, we're forcing the JavaScript engine to parse and evaluate thousands of lines of API code even for routes the user may never visit. There's no code splitting, no lazy loading, no optimization for the critical path. Every user pays the full cost of our entire API surface, regardless of which features they actually use.",{"_29":12804,"_31":12805},[],{"_33":6334,"_35":12806,"_37":2069,"_39":12807,"_63":12808,"_65":66,"_67":12809},"C55Pjxeo",{"_2719":243},[],"ipfs://bafybeieypd2gtgbttltmj5cmlvi2taakxt4cmnjfizbrrmoub2bjlw5imi",{"_33":3020,"_35":12811,"_37":2078,"_39":12812,"_63":12813,"_65":9373,"_67":66},"B10HQgrv",{"_2719":243},[],{"_29":12815,"_31":12868},[12816,12823,12835,12842,12855],{"_29":12817,"_31":12818},[],{"_33":2680,"_35":12819,"_37":2078,"_39":12820,"_63":12821,"_65":12822,"_67":66},"9lb9xx2F",{},[],"The path forward requires surgical precision, not wholesale replacement. We don't need to rip out electron-trpc entirely—we need to recognize where it adds value and where it extracts a performance cost that exceeds its benefits.",{"_29":12824,"_31":12825},[],{"_33":2680,"_35":12826,"_37":2078,"_39":12827,"_63":12828,"_65":12834,"_67":66},"TNrX6TZy",{},[12829],{"_33":2751,"_2788":12830,"_2790":12831,"_39":12833,"_67":66},[11304],[12832],157,{},"For the 39% of our procedures that are simple getters and setters, standard Electron IPC is the clear winner. A function like getSetting(key: string): string doesn't need Zod validation, doesn't benefit from complex type inference, and certainly doesn't warrant the overhead of SuperJSON transformation. These should be implemented as direct IPC calls exposed through contextBridge, giving us type safety at the interface boundary without the runtime overhead. We can still maintain TypeScript types for these APIs—they just won't be automatically derived from tRPC routers.",{"_29":12836,"_31":12837},[],{"_33":2680,"_35":12838,"_37":2078,"_39":12839,"_63":12840,"_65":12841,"_67":66},"rXae6BBm",{},[],"For complex operations—draft management with its file I/O and migration logic, web content importing with its multi-step transformations, or any procedure with sophisticated input validation—electron-trpc remains valuable. These operations already have significant execution time measured in hundreds of milliseconds, so the additional IPC overhead is noise. The type safety and validation genuinely prevent bugs in these complex code paths.",{"_29":12843,"_31":12844},[],{"_33":2680,"_35":12845,"_37":2078,"_39":12846,"_63":12847,"_65":12854,"_67":66},"ZU4ZlRQz",{},[12848],{"_33":2751,"_2788":12849,"_2790":12851,"_39":12853,"_67":66},[12850],362,[12852],378,{},"The second critical change is implementing proper code splitting. Our tRPC routers should be lazy-loaded by feature area. When a user opens the settings window, that's when we load the settings router. When they access drafts, that's when the drafts API becomes available. This requires restructuring our router tree to support dynamic imports and deferring the createIPCHandler call until routers are actually needed. It's more complex than our current eager-loading approach, but it's the difference between a 2-second startup and a 5-second startup.",{"_29":12856,"_31":12857},[],{"_33":2680,"_35":12858,"_37":2078,"_39":12859,"_63":12860,"_65":12867,"_67":66},"KviZ4y8T",{},[12861],{"_33":3084,"_2788":12862,"_2790":12864,"_39":12866,"_67":66},[12863],508,[12865],564,{},"Finally, we need to stop blocking the window creation on our full initialization sequence. The current pattern—spawn daemon, wait for it to become ready (up to 10 seconds), initialize drafts with file I/O, then finally show the window—is user-hostile. Instead, we should show the window immediately with a proper loading state, then initialize the daemon and drafts in parallel while providing real-time progress updates. This isn't strictly an electron-trpc issue, but it's symptomatic of the same mindset: prioritizing developer convenience over user experience.",{"_33":3020,"_35":12869,"_37":2078,"_39":12870,"_63":12871,"_65":9476,"_67":66},"TF1EKkKj",{"_2719":243},[],{"_29":12873,"_31":12935},[12874,12881,12896,12915,12922],{"_29":12875,"_31":12876},[],{"_33":2680,"_35":12877,"_37":2078,"_39":12878,"_63":12879,"_65":12880,"_67":66},"iX8Miwjm",{},[],"The most dangerous rabbit hole when migrating away from electron-trpc is the temptation to build your own type-safe IPC abstraction. You'll be tempted to think:",{"_29":12882,"_31":12883},[],{"_33":2680,"_35":12884,"_37":2078,"_39":12885,"_63":12886,"_65":12895,"_67":66},"HHZWS8ko",{},[12887,12891],{"_33":9788,"_2788":12888,"_2790":12889,"_39":12890,"_67":66},[42],[8236],{},{"_33":3084,"_2788":12892,"_2790":12893,"_39":12894,"_67":66},[6610],[2854],{},"\"we can keep the type safety without the overhead by building a lighter-weight version.\" Don't.",{"_29":12897,"_31":12898},[],{"_33":2680,"_35":12899,"_37":2078,"_39":12900,"_63":12901,"_65":12914,"_67":66},"xnDoDSK_",{},[12902,12908],{"_33":3084,"_2788":12903,"_2790":12905,"_39":12907,"_67":66},[12904],299,[12906],321,{},{"_33":2751,"_2788":12909,"_2790":12911,"_39":12913,"_67":66},[12910],343,[12912],361,{},"The complexity of maintaining type synchronization between main and renderer processes, handling serialization edge cases, managing subscriptions, and keeping everything working as your API evolves will consume weeks of engineering time for marginal gains. If you're moving away from electron-trpc, move toward simplicity, not toward building electron-trpc-lite.",{"_29":12916,"_31":12917},[],{"_33":2680,"_35":12918,"_37":2078,"_39":12919,"_63":12920,"_65":12921,"_67":66},"Qw2TvnRq",{},[],"Another trap is trying to maintain 100% feature parity during migration. You'll find yourself recreating tRPC's subscription mechanism, its batching capabilities, its middleware system. Each recreation adds back the complexity you're trying to remove. Instead, ask whether you actually use these features. In our codebase, we use subscriptions in exactly one place for query invalidation—we could replace that with a simple event emitter in five minutes. Batching? We're not making multiple related calls that would benefit from it. Middleware? We don't have any. Don't rebuild features you're not using.",{"_29":12923,"_31":12924},[],{"_33":2680,"_35":12925,"_37":2078,"_39":12926,"_63":12927,"_65":12934,"_67":66},"-ChEbuHd",{},[12928],{"_33":3084,"_2788":12929,"_2790":12931,"_39":12933,"_67":66},[12930],516,[12932],541,{},"The third rabbit hole is perfectionism around migration strategy. You'll want to create detailed plans for migrating all 109 procedures, establishing patterns, writing comprehensive tests for the new IPC layer. This planning phase will expand to fill weeks while your users continue to experience slow startup times. Instead, pick the lowest-hanging fruit—those 42 simple getters and setters—and migrate them in a single focused session. Prove the pattern works, measure the impact, then decide whether to continue. Progress beats perfection.",{"_33":3020,"_35":12936,"_37":2078,"_39":12937,"_63":12938,"_65":12939,"_67":66},"nRwAMhpG",{"_2719":243},[],"Rabbit Holes",{"_29":12941,"_31":13012},[12942,12953,12972,12979,12992,12999],{"_29":12943,"_31":12944},[],{"_33":2680,"_35":12945,"_37":2078,"_39":12946,"_63":12947,"_65":12952,"_67":66},"UNaxdog2",{},[12948],{"_33":2751,"_2788":12949,"_2790":12950,"_39":12951,"_67":66},[6426],[8306],{},"The scope of this effort is deliberately constrained. We're not removing electron-trpc entirely, we're not rewriting the entire IPC layer, and we're not solving every performance issue in the application. We're making three targeted changes that address the most egregious performance problems with the highest return on investment.",{"_29":12954,"_31":12955},[],{"_33":2680,"_35":12956,"_37":2078,"_39":12957,"_63":12958,"_65":12971,"_67":66},"w6AEuv8L",{},[12959],{"_33":2751,"_2788":12960,"_2790":12965,"_39":12970,"_67":66},[12961,12962,12963,12964],344,386,472,481,[12966,12967,12968,12969],357,393,476,490,{},"First, migrate simple getters and setters (the 42 identified procedures) to direct IPC. This includes settings, favorites, recents, and similar single-value operations. These should be completed in a single pull request to avoid having two patterns for simple operations living in the codebase simultaneously. The pattern should be consistent: contextBridge exposes a typed API object, ipcMain handlers implement the logic, and components use the exposed API directly. No tRPC, no SuperJSON, no router traversal.",{"_29":12973,"_31":12974},[],{"_33":2680,"_35":12975,"_37":2078,"_39":12976,"_63":12977,"_65":12978,"_67":66},"IcUzDYbF",{},[],"Second, implement lazy loading for tRPC routers that remain. This means splitting the monolithic router into feature-based modules that can be dynamically imported. The drafts router loads when the drafts feature is accessed. The web importing router loads when import functionality is needed. The settings router can stay eagerly loaded since it's needed for initial app configuration. This will require modifying how we create the IPC handlers and potentially introducing a router registry pattern, but it's a one-time infrastructure change that benefits all routers.",{"_29":12980,"_31":12981},[],{"_33":2680,"_35":12982,"_37":2078,"_39":12983,"_63":12984,"_65":12991,"_67":66},"wpeUixFL",{},[12985],{"_33":2751,"_2788":12986,"_2790":12988,"_39":12990,"_67":66},[6791,12987],417,[7540,12989],430,{},"Third, improve the startup sequence to handle daemon initialization gracefully. Work is already underway in the feat/app-startup branch to check daemon state and show a dedicated loading window when the daemon is migrating, rather than blocking the main window creation. This approach gives users immediate visual feedback and prevents the blank screen experience during daemon startup. While not strictly related to electron-trpc, it's the most visible performance problem users experience, and completing this work removes the artificial coupling between daemon readiness and window visibility.",{"_29":12993,"_31":12994},[],{"_33":6334,"_35":12995,"_37":2069,"_39":12996,"_63":12997,"_65":66,"_67":12998},"kA2pfoLW",{"_2719":243},[],"ipfs://bafybeiawbu3w7d6vszex3jf2qj2a6hu7iefhag7bo6tfdi6ac3sakmmpqm",{"_29":13000,"_31":13001},[],{"_33":2680,"_35":13002,"_37":2078,"_39":13003,"_63":13004,"_65":13011,"_67":66},"9XZUZFxu",{},[13005],{"_33":9788,"_2788":13006,"_2790":13008,"_39":13010,"_67":66},[13007],243,[13009],252,{},"What's explicitly out of scope: rewriting complex operations like draft management or web importing. These procedures have sophisticated logic and benefit from tRPC's type safety. Also out of scope: building abstractions to make the migration \"cleaner\" or trying to maintain identical APIs between the old and new approaches. Different paradigms can have different interfaces—that's fine.",{"_33":3020,"_35":13013,"_37":2078,"_39":13014,"_63":13015,"_65":13016,"_67":66},"hQ5Ujb2_",{"_2719":243},[],"Scope",{"_29":13018,"_31":13078},[13019,13030,13037,13049,13056],{"_29":13020,"_31":13021},[],{"_33":2680,"_35":13022,"_37":2078,"_39":13023,"_63":13024,"_65":13029,"_67":66},"Z9t6DXex",{},[13025],{"_33":3084,"_2788":13026,"_2790":13027,"_39":13028,"_67":66},[144],[175],{},"Do not attempt to build a custom type-safe IPC framework as part of this effort. The goal is to reduce complexity, not to replace one abstraction with another that we have to maintain. If you find yourself writing code that generates types from schemas or automatically syncs interfaces between processes, stop immediately. You're rebuilding tRPC and you will regret it.",{"_29":13031,"_31":13032},[],{"_33":2680,"_35":13033,"_37":2078,"_39":13034,"_63":13035,"_65":13036,"_67":66},"q3AzVdHa",{},[],"Do not migrate complex procedures away from electron-trpc just for consistency. If a procedure has multiple input parameters, complex validation logic, or sophisticated error handling, it's probably fine to keep it in tRPC. The performance overhead is only problematic when it's disproportionate to the operation's inherent cost. A draft creation operation that does file I/O, validation, and database writes can afford an extra 2 milliseconds of IPC overhead. A boolean getter cannot.",{"_29":13038,"_31":13039},[],{"_33":2680,"_35":13040,"_37":2078,"_39":13041,"_63":13042,"_65":13048,"_67":66},"37GrdmuE",{},[13043],{"_33":3084,"_2788":13044,"_2790":13045,"_39":13047,"_67":66},[8248],[13046],375,{},"Do not introduce new dependencies to solve these problems. There will be temptation to bring in libraries for IPC message validation, for type generation, for performance monitoring. Each dependency is a future maintenance burden and a potential attack surface. Electron's built-in IPC with TypeScript interfaces is sufficient for our needs in this particular simple usecases. If it feels too manual compared to tRPC, that's because you're doing less work at runtime—which is the entire point.",{"_29":13050,"_31":13051},[],{"_33":2680,"_35":13052,"_37":2078,"_39":13053,"_63":13054,"_65":13055,"_67":66},"6VqWIsKJ",{},[],"Do not skip measuring the impact of changes. Before migrating procedures, establish baseline metrics: startup time, time to first render, bundle size. After migration, measure again. If you're not seeing measurable improvements, you may be optimizing the wrong thing. Performance work without measurement is just guessing, and guessing wastes time that could be spent on features users actually want.",{"_29":13057,"_31":13058},[],{"_33":2680,"_35":13059,"_37":2078,"_39":13060,"_63":13061,"_65":13077,"_67":66},"qSPrTxzY",{},[13062,13068],{"_33":2751,"_2788":13063,"_2790":13065,"_39":13067,"_67":66},[6612,13064],384,[6790,13066],397,{},{"_33":9788,"_2788":13069,"_2790":13073,"_39":13076,"_67":66},[13070,13071,13072],191,213,246,[11891,13074,13075],216,249,{},"Finally, do not let this migration become a referendum on electron-trpc as a technology. It's a well-built library that solves real problems for many applications. It's not the right fit for our application given our performance requirements and our API patterns. That's a specific conclusion about specific circumstances, not a universal truth. When you're done with this migration, electron-trpc will still be a good choice for applications where the DX benefits outweigh the runtime costs—applications with complex APIs, web-based backends that need IPC adapters, or tools where load time isn't critical. We're just not one of those applications.",{"_33":3020,"_35":13079,"_37":2078,"_39":13080,"_63":13081,"_65":13082,"_67":66},"ZU3bw_ZC",{"_2719":243},[],"No-Gos",[76],"/tech-talks/the-case-against-electron-trpc-when-type-safety-becomes-a-performance-tax","2025-12-19T17:26:27.410Z",{"_84":2092,"_86":2093,"_190":2094},{},{"_90":2078,"_94":2090},{"_35":2066,"_102":51,"_52":13090,"_68":2069,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2068],1779255260604,[156,2066,2069,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/the-case-against-electron-trpc-when-type-safety-becomes-a-performance-tax\",\"bafy2bzaceamy4oebix7slrvg7fdk3hm3rxmbsvu7ergjp54tkckt664x642vg\",true]",{"_117":13095,"_154":14824,"_157":14825},{"_119":13096,"_139":42,"_140":14823,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":13097,"_35":14821},{"_26":13098,"_68":2100,"_69":51,"_70":14815,"_52":14816,"_78":2109,"_80":14817,"_82":14818,"_88":14819,"_90":2110,"_92":14820,"_96":97},[13099,13167,13258,13685,14076,14447,14543,14695,14760],{"_29":13100,"_31":13162},[13101,13134],{"_29":13102,"_31":13129},[13103,13114],{"_29":13104,"_31":13105},[],{"_33":2680,"_35":13106,"_37":2110,"_39":13107,"_63":13108,"_65":13113,"_67":66},"sMe1bJ4Z",{},[13109],{"_33":3084,"_2788":13110,"_2790":13111,"_39":13112,"_67":66},[144,2551],[1835,3926],{},"Date: December 2025 Issue: Perceived performance regression after SSR implementation",{"_29":13115,"_31":13116},[],{"_33":2680,"_35":13117,"_37":2110,"_39":13118,"_63":13119,"_65":13128,"_67":66},"qP22V8SY",{},[13120,13124],{"_33":3084,"_2788":13121,"_2790":13122,"_39":13123,"_67":66},[144],[7514],{},{"_33":2751,"_2788":13125,"_2790":13126,"_39":13127,"_67":66},[2839],[2889],{},"Root Cause: Commit deea8a4bf (\"Attempt to streamline server rendering loaders\") removed query block prefetching logic, causing client-side waterfall fetches for pages with Query blocks.",{"_33":3020,"_35":13130,"_37":2110,"_39":13131,"_63":13132,"_65":13133,"_67":66},"7MLS6D-c",{"_2719":243},[],"Performance Regression Identified",{"_29":13135,"_31":13157},[13136,13143,13150],{"_29":13137,"_31":13138},[],{"_33":2680,"_35":13139,"_37":2110,"_39":13140,"_63":13141,"_65":13142,"_67":66},"KfR5aN-I",{},[],"Pages with Query blocks now trigger multiple client-side round trips instead of being server-rendered",{"_29":13144,"_31":13145},[],{"_33":2680,"_35":13146,"_37":2110,"_39":13147,"_63":13148,"_65":13149,"_67":66},"Xgz91EEb",{},[],"Lost ~67 lines of critical prefetching code",{"_29":13151,"_31":13152},[],{"_33":2680,"_35":13153,"_37":2110,"_39":13154,"_63":13155,"_65":13156,"_67":66},"aCc_OUaM",{},[],"Estimated performance degradation: 50-70% slower for query-heavy pages",{"_33":3020,"_35":13158,"_37":2110,"_39":13159,"_63":13160,"_65":13161,"_67":66},"rkuGP7zu",{"_2719":2972},[],"Impact",{"_33":3020,"_35":13163,"_37":2110,"_39":13164,"_63":13165,"_65":13166,"_67":66},"COxk496R",{"_2719":243},[],"Background",{"_29":13168,"_31":13253},[13169],{"_29":13170,"_31":13248},[13171,13186,13229,13240],{"_29":13172,"_31":13173},[],{"_33":2680,"_35":13174,"_37":2110,"_39":13175,"_63":13176,"_65":13185,"_67":66},"-6u65yGY",{},[13177,13181],{"_33":3084,"_2788":13178,"_2790":13179,"_39":13180,"_67":66},[144,2920],[1835,2878],{},{"_33":2751,"_2788":13182,"_2790":13183,"_39":13184,"_67":66},[649],[6837],{},"File: frontend/apps/web/app/loaders.ts Lines: 317-357",{"_29":13187,"_31":13220},[13188,13195,13202,13209],{"_29":13189,"_31":13190},[],{"_33":2680,"_35":13191,"_37":2110,"_39":13192,"_63":13193,"_65":13194,"_67":66},"uQ490CZQ",{},[],"Query block extraction from document content",{"_29":13196,"_31":13197},[],{"_33":2680,"_35":13198,"_37":2110,"_39":13199,"_63":13200,"_65":13201,"_67":66},"1wIsjEW6",{},[],"Server-side query execution",{"_29":13203,"_31":13204},[],{"_33":2680,"_35":13205,"_37":2110,"_39":13206,"_63":13207,"_65":13208,"_67":66},"P5cyq9x1",{},[],"Prefetching of all query result documents",{"_29":13210,"_31":13211},[],{"_33":2680,"_35":13212,"_37":2110,"_39":13213,"_63":13214,"_65":13219,"_67":66},"ghtysyiH",{},[13215],{"_33":2751,"_2788":13216,"_2790":13217,"_39":13218,"_67":66},[4245],[3088],{},"Graceful error handling with Promise.allSettled",{"_33":2680,"_35":13221,"_37":2110,"_39":13222,"_63":13223,"_65":13228,"_67":66},"wM-B4-c6",{"_2719":3238},[13224],{"_33":3084,"_2788":13225,"_2790":13226,"_39":13227,"_67":66},[144],[1057],{},"Restored:",{"_29":13230,"_31":13231},[],{"_33":2680,"_35":13232,"_37":2110,"_39":13233,"_63":13234,"_65":13239,"_67":66},"Qt_b90_k",{},[13235],{"_33":3084,"_2788":13236,"_2790":13237,"_39":13238,"_67":66},[144],[7514],{},"Code Added:",{"_29":13241,"_31":13242},[],{"_33":2751,"_35":13243,"_37":2110,"_39":13244,"_63":13246,"_65":13247,"_67":66},"3neqRv2l",{"_2753":13245},"typescript",[],"// CRITICAL: Extract and prefetch query blocks (RESTORED)\nconst queryBlocks = extractQueryBlocks(document.content)\n\nif (queryBlocks.length > 0) {\n await instrument(ctx || noopCtx, 'prefetchQueryBlocks', async () => {\n const queryBlockQueries = await Promise.all(\n queryBlocks.map(async (block) => {\n try {\n return await getQueryResults(block.attributes.query)\n } catch (e) {\n console.error('Error executing query block', e)\n return null\n }\n }),\n )\n\n // Add query result documents to embeddedDocs for prefetching\n const queryResultDocs = await Promise.allSettled(\n queryBlockQueries\n .filter((item) => item !== null && item.results)\n .flatMap((item) => item!.results)\n .map(async (item) => {\n try {\n const id = item.id\n const document = await getDocument(id)\n return {id, document}\n } catch (e) {\n console.error('Error fetching query result document', item.id, e)\n return null\n }\n }),\n )\n\n // Add successfully fetched query result docs to embeddedDocs\n queryResultDocs.forEach((result) => {\n if (result.status === 'fulfilled' && result.value) {\n embeddedDocs.push(result.value)\n }\n })\n })\n}\n",{"_33":3020,"_35":13249,"_37":2110,"_39":13250,"_63":13251,"_65":13252,"_67":66},"qmtZJidw",{"_2719":243},[],"Changes Made",{"_33":3020,"_35":13254,"_37":2110,"_39":13255,"_63":13256,"_65":13257,"_67":66},"_OVWLPoP",{"_2719":243},[],"Phase 1: Fix Regression (COMPLETED)",{"_29":13259,"_31":13680},[13260],{"_29":13261,"_31":13675},[13262,13269,13357,13448,13595],{"_29":13263,"_31":13264},[],{"_33":2680,"_35":13265,"_37":2110,"_39":13266,"_63":13267,"_65":13268,"_67":66},"itI-er-f",{},[],"Based on analysis of the SSR implementation, the following bottlenecks were identified:",{"_29":13270,"_31":13348},[13271,13286,13297,13304],{"_29":13272,"_31":13273},[],{"_33":2680,"_35":13274,"_37":2110,"_39":13275,"_63":13276,"_65":13285,"_67":66},"RbH525_8",{},[13277,13281],{"_33":3084,"_2788":13278,"_2790":13279,"_39":13280,"_67":66},[144,439,6613],[1835,783,9385],{},{"_33":2751,"_2788":13282,"_2790":13283,"_39":13284,"_67":66},[649],[3243],{},"File: frontend/apps/web/app/root.tsx Issue: No preconnect or dns-prefetch hints for external services Impact: ~100-300ms overhead per origin for DNS + TLS",{"_29":13287,"_31":13288},[],{"_33":2680,"_35":13289,"_37":2110,"_39":13290,"_63":13291,"_65":13296,"_67":66},"sGovS3T_",{},[13292],{"_33":3084,"_2788":13293,"_2790":13294,"_39":13295,"_67":66},[144],[2805],{},"Current State:",{"_29":13298,"_31":13299},[],{"_33":2751,"_35":13300,"_37":2110,"_39":13301,"_63":13302,"_65":13303,"_67":66},"G7_6t1m1",{"_2753":13245},[],"export const links: LinksFunction = () => {\n return [\n {rel: 'stylesheet', href: globalStyles},\n {rel: 'stylesheet', href: localTailwindStyles},\n {rel: 'stylesheet', href: sonnerStyles},\n {rel: 'stylesheet', href: slashMenuStyles},\n ]\n}\n",{"_29":13305,"_31":13339},[13306,13317,13328],{"_29":13307,"_31":13308},[],{"_33":2680,"_35":13309,"_37":2110,"_39":13310,"_63":13311,"_65":13316,"_67":66},"06bOtqVb",{},[13312],{"_33":2751,"_2788":13313,"_2790":13314,"_39":13315,"_67":66},[144,2918],[2087,6695],{},"DAEMON_HTTP_URL / SEED_ASSET_HOST - Main backend API",{"_29":13318,"_31":13319},[],{"_33":2680,"_35":13320,"_37":2110,"_39":13321,"_63":13322,"_65":13327,"_67":66},"Xp5TYkJi",{},[13323],{"_33":2751,"_2788":13324,"_2790":13325,"_39":13326,"_67":66},[144],[2821],{},"LIGHTNING_API_URL - Lightning network API",{"_29":13329,"_31":13330},[],{"_33":2680,"_35":13331,"_37":2110,"_39":13332,"_63":13333,"_65":13338,"_67":66},"QxfcBr3M",{},[13334],{"_33":2751,"_2788":13335,"_2790":13336,"_39":13337,"_67":66},[144],[2839],{},"NOTIFY_SERVICE_HOST - Notification service",{"_33":2680,"_35":13340,"_37":2110,"_39":13341,"_63":13342,"_65":13347,"_67":66},"9hFKL-SA",{"_2719":2972},[13343],{"_33":3084,"_2788":13344,"_2790":13345,"_39":13346,"_67":66},[144],[2836],{},"Services to preconnect:",{"_33":3020,"_35":13349,"_37":2110,"_39":13350,"_63":13351,"_65":13356,"_67":66},"WDHlk1mL",{"_2719":243},[13352],{"_33":3084,"_2788":13353,"_2790":13354,"_39":13355,"_67":66},[170],[2551],{},"1. No Resource Hints",{"_29":13358,"_31":13439},[13359,13374,13389,13400,13407],{"_29":13360,"_31":13361},[],{"_33":2680,"_35":13362,"_37":2110,"_39":13363,"_63":13364,"_65":13373,"_67":66},"laA1a2Vf",{},[13365,13369],{"_33":3084,"_2788":13366,"_2790":13367,"_39":13368,"_67":66},[144,783],[1835,3088],{},{"_33":2751,"_2788":13370,"_2790":13371,"_39":13372,"_67":66},[649],[8222],{},"File: frontend/apps/web/app/providers.tsx Lines: 38-49",{"_29":13375,"_31":13376},[],{"_33":2680,"_35":13377,"_37":2110,"_39":13378,"_63":13379,"_65":13388,"_67":66},"Iivcsnif",{},[13380,13384],{"_33":3084,"_2788":13381,"_2790":13382,"_39":13383,"_67":66},[144],[390],{},{"_33":2751,"_2788":13385,"_2790":13386,"_39":13387,"_67":66},[882],[7703],{},"Issue: staleTime: Infinity prevents background data freshness",{"_29":13390,"_31":13391},[],{"_33":2680,"_35":13392,"_37":2110,"_39":13393,"_63":13394,"_65":13399,"_67":66},"Z326Tel-",{},[13395],{"_33":3084,"_2788":13396,"_2790":13397,"_39":13398,"_67":66},[144],[912],{},"Current Config:",{"_29":13401,"_31":13402},[],{"_33":2751,"_35":13403,"_37":2110,"_39":13404,"_63":13405,"_65":13406,"_67":66},"aDiUcuIw",{"_2753":13245},[],"function createQueryClient() {\n return new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: Infinity, // ⚠️ Never considers data stale\n refetchOnMount: false,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n },\n },\n })\n}\n",{"_29":13408,"_31":13430},[13409,13416,13423],{"_29":13410,"_31":13411},[],{"_33":2680,"_35":13412,"_37":2110,"_39":13413,"_63":13414,"_65":13415,"_67":66},"R6LROA3p",{},[],"Good for SSR cache",{"_29":13417,"_31":13418},[],{"_33":2680,"_35":13419,"_37":2110,"_39":13420,"_63":13421,"_65":13422,"_67":66},"B7OfyOoj",{},[],"Bad for client-side navigation (no fresh data checks)",{"_29":13424,"_31":13425},[],{"_33":2680,"_35":13426,"_37":2110,"_39":13427,"_63":13428,"_65":13429,"_67":66},"gLNhRgRH",{},[],"Users see stale data even after long sessions",{"_33":2680,"_35":13431,"_37":2110,"_39":13432,"_63":13433,"_65":13438,"_67":66},"s-dP1f73",{"_2719":2972},[13434],{"_33":3084,"_2788":13435,"_2790":13436,"_39":13437,"_67":66},[144],[649],{},"Impact:",{"_33":3020,"_35":13440,"_37":2110,"_39":13441,"_63":13442,"_65":13447,"_67":66},"Oif5bAm2",{"_2719":243},[13443],{"_33":3084,"_2788":13444,"_2790":13445,"_39":13446,"_67":66},[170],[2920],{},"2. Suboptimal React Query Configuration",{"_29":13449,"_31":13586},[13450,13465,13476,13575],{"_29":13451,"_31":13452},[],{"_33":2680,"_35":13453,"_37":2110,"_39":13454,"_63":13455,"_65":13464,"_67":66},"IW8jXkOT",{},[13456,13460],{"_33":3084,"_2788":13457,"_2790":13458,"_39":13459,"_67":66},[144,2920],[1835,2878],{},{"_33":2751,"_2788":13461,"_2790":13462,"_39":13463,"_67":66},[649],[6837],{},"File: frontend/apps/web/app/loaders.ts Lines: 381-419",{"_29":13466,"_31":13467},[],{"_33":2680,"_35":13468,"_37":2110,"_39":13469,"_63":13470,"_65":13475,"_67":66},"yqXnz7Q7",{},[13471],{"_33":3084,"_2788":13472,"_2790":13473,"_39":13474,"_67":66},[144],[390],{},"Issue: All prefetches block shell render, including non-critical data",{"_29":13477,"_31":13566},[13478,13489,13500,13511,13522,13533,13544,13555],{"_29":13479,"_31":13480},[],{"_33":2680,"_35":13481,"_37":2110,"_39":13482,"_63":13483,"_65":13488,"_67":66},"N54B9GGL",{},[13484],{"_33":2751,"_2788":13485,"_2790":13486,"_39":13487,"_67":66},[516],[2965],{},"✅ getAuthors (critical - needed for metadata)",{"_29":13490,"_31":13491},[],{"_33":2680,"_35":13492,"_37":2110,"_39":13493,"_63":13494,"_65":13499,"_67":66},"gS9Pi66Y",{},[13495],{"_33":2751,"_2788":13496,"_2790":13497,"_39":13498,"_67":66},[170],[2918],{},"⚠️ getEmbeddedDocs (non-critical - can defer)",{"_29":13501,"_31":13502},[],{"_33":2680,"_35":13503,"_37":2110,"_39":13504,"_63":13505,"_65":13510,"_67":66},"kQIbVfrS",{},[13506],{"_33":2751,"_2788":13507,"_2790":13508,"_39":13509,"_67":66},[516],[8172],{},"✅ getHomeAndDirectories (critical - needed for navigation)",{"_29":13512,"_31":13513},[],{"_33":2680,"_35":13514,"_37":2110,"_39":13515,"_63":13516,"_65":13521,"_67":66},"3h1PAkTp",{},[13517],{"_33":2751,"_2788":13518,"_2790":13519,"_39":13520,"_67":66},[170],[2836],{},"⚠️ prefetchQueryBlocks (non-critical - can defer)",{"_29":13523,"_31":13524},[],{"_33":2680,"_35":13525,"_37":2110,"_39":13526,"_63":13527,"_65":13532,"_67":66},"vP6r9Ebg",{},[13528],{"_33":2751,"_2788":13529,"_2790":13530,"_39":13531,"_67":66},[516],[1182],{},"✅ getBreadcrumbs (critical - needed for UI)",{"_29":13534,"_31":13535},[],{"_33":2680,"_35":13536,"_37":2110,"_39":13537,"_63":13538,"_65":13543,"_67":66},"wObWDct8",{},[13539],{"_33":2751,"_2788":13540,"_2790":13541,"_39":13542,"_67":66},[170],[7703],{},"⚠️ queryInteractionSummary (non-critical - comment counts)",{"_29":13545,"_31":13546},[],{"_33":2680,"_35":13547,"_37":2110,"_39":13548,"_63":13549,"_65":13554,"_67":66},"ANAUWdq7",{},[13550],{"_33":2751,"_2788":13551,"_2790":13552,"_39":13553,"_67":66},[170],[8172],{},"⚠️ prefetchEmbeddedDocs (non-critical - can defer)",{"_29":13556,"_31":13557},[],{"_33":2680,"_35":13558,"_37":2110,"_39":13559,"_63":13560,"_65":13565,"_67":66},"d0UomZJN",{},[13561],{"_33":2751,"_2788":13562,"_2790":13563,"_39":13564,"_67":66},[170],[2839],{},"⚠️ prefetchAccounts (non-critical - can defer)",{"_33":2680,"_35":13567,"_37":2110,"_39":13568,"_63":13569,"_65":13574,"_67":66},"HI51yJXf",{"_2719":3238},[13570],{"_33":3084,"_2788":13571,"_2790":13572,"_39":13573,"_67":66},[144],[6286],{},"Current Blocking Operations:",{"_29":13576,"_31":13577},[],{"_33":2680,"_35":13578,"_37":2110,"_39":13579,"_63":13580,"_65":13585,"_67":66},"cGK3r0-h",{},[13581],{"_33":3084,"_2788":13582,"_2790":13583,"_39":13584,"_67":66},[144],[649],{},"Impact: Server response delayed by ~200-500ms for non-critical data",{"_33":3020,"_35":13587,"_37":2110,"_39":13588,"_63":13589,"_65":13594,"_67":66},"Kttsxs3D",{"_2719":243},[13590],{"_33":3084,"_2788":13591,"_2790":13592,"_39":13593,"_67":66},[170],[491],{},"3. All Prefetching is Blocking",{"_29":13596,"_31":13666},[13597,13612,13623,13655],{"_29":13598,"_31":13599},[],{"_33":2680,"_35":13600,"_37":2110,"_39":13601,"_63":13602,"_65":13611,"_67":66},"wDQEThHR",{},[13603,13607],{"_33":3084,"_2788":13604,"_2790":13605,"_39":13606,"_67":66},[144],[1835],{},{"_33":2751,"_2788":13608,"_2790":13609,"_39":13610,"_67":66},[649],[6567],{},"File: frontend/apps/web/app/routes/$.tsx",{"_29":13613,"_31":13614},[],{"_33":2680,"_35":13615,"_37":2110,"_39":13616,"_63":13617,"_65":13622,"_67":66},"f5uzS725",{},[13618],{"_33":3084,"_2788":13619,"_2790":13620,"_39":13621,"_67":66},[144],[390],{},"Issue: All loader data blocks initial response",{"_29":13624,"_31":13646},[13625,13632,13639],{"_29":13626,"_31":13627},[],{"_33":2680,"_35":13628,"_37":2110,"_39":13629,"_63":13630,"_65":13631,"_67":66},"23DWokoW",{},[],"Interaction summaries (comments, likes)",{"_29":13633,"_31":13634},[],{"_33":2680,"_35":13635,"_37":2110,"_39":13636,"_63":13637,"_65":13638,"_67":66},"JeVdzAGP",{},[],"Embedded documents",{"_29":13640,"_31":13641},[],{"_33":2680,"_35":13642,"_37":2110,"_39":13643,"_63":13644,"_65":13645,"_67":66},"Kit2Prfa",{},[],"Query block results",{"_33":2680,"_35":13647,"_37":2110,"_39":13648,"_63":13649,"_65":13654,"_67":66},"O40I_xpN",{"_2719":2972},[13650],{"_33":3084,"_2788":13651,"_2790":13652,"_39":13653,"_67":66},[144],[1300],{},"Opportunity: Stream non-critical data after shell renders",{"_29":13656,"_31":13657},[],{"_33":2680,"_35":13658,"_37":2110,"_39":13659,"_63":13660,"_65":13665,"_67":66},"yRHmkHVE",{},[13661],{"_33":3084,"_2788":13662,"_2790":13663,"_39":13664,"_67":66},[144],[7514],{},"Complexity: Requires UI changes for Suspense/Await boundaries",{"_33":3020,"_35":13667,"_37":2110,"_39":13668,"_63":13669,"_65":13674,"_67":66},"ktYFIkbE",{"_2719":243},[13670],{"_33":3084,"_2788":13671,"_2790":13672,"_39":13673,"_67":66},[170],[2839],{},"4. No defer() Usage",{"_33":3020,"_35":13676,"_37":2110,"_39":13677,"_63":13678,"_65":13679,"_67":66},"Ah3meE-f",{"_2719":243},[],"Current Performance Bottlenecks",{"_33":3020,"_35":13681,"_37":2110,"_39":13682,"_63":13683,"_65":13684,"_67":66},"JFVGIiGQ",{"_2719":243},[],"Phase 2: Performance Optimizations",{"_29":13686,"_31":14071},[13687,13738,13876,13959],{"_29":13688,"_31":13733},[13689,13704,13715,13722],{"_29":13690,"_31":13691},[],{"_33":2680,"_35":13692,"_37":2110,"_39":13693,"_63":13694,"_65":13703,"_67":66},"YjvYrugU",{},[13695,13699],{"_33":3084,"_2788":13696,"_2790":13697,"_39":13698,"_67":66},[144,439],[1835,6424],{},{"_33":2751,"_2788":13700,"_2790":13701,"_39":13702,"_67":66},[649],[3243],{},"File: frontend/apps/web/app/root.tsx Lines to modify: 29-36",{"_29":13705,"_31":13706},[],{"_33":2680,"_35":13707,"_37":2110,"_39":13708,"_63":13709,"_65":13714,"_67":66},"9N5Q1ur6",{},[13710],{"_33":3084,"_2788":13711,"_2790":13712,"_39":13713,"_67":66},[144],[912],{},"Implementation:",{"_29":13716,"_31":13717},[],{"_33":2751,"_35":13718,"_37":2110,"_39":13719,"_63":13720,"_65":13721,"_67":66},"QZ-Ti1IK",{"_2753":13245},[],"export const links: LinksFunction = () => {\n // Get environment variables injected by loader\n const daemonUrl =\n typeof window !== 'undefined'\n ? window.ENV?.SEED_ASSET_HOST || 'http://localhost:56001'\n : 'http://localhost:56001'\n\n const lightningUrl =\n typeof window !== 'undefined'\n ? window.ENV?.LIGHTNING_API_URL || 'https://ln.seed.hyper.media'\n : 'https://ln.seed.hyper.media'\n\n return [\n // Resource hints - CRITICAL for performance\n {rel: 'preconnect', href: daemonUrl, crossOrigin: 'anonymous'},\n {rel: 'dns-prefetch', href: lightningUrl},\n\n // Existing stylesheets\n {rel: 'stylesheet', href: globalStyles},\n {rel: 'stylesheet', href: localTailwindStyles},\n {rel: 'stylesheet', href: sonnerStyles},\n {rel: 'stylesheet', href: slashMenuStyles},\n ]\n}\n",{"_29":13723,"_31":13724},[],{"_33":2680,"_35":13725,"_37":2110,"_39":13726,"_63":13727,"_65":13732,"_67":66},"ewjE6_JL",{},[13728],{"_33":3084,"_2788":13729,"_2790":13730,"_39":13731,"_67":66},[144],[2551],{},"Expected improvement: 100-300ms faster first request to each origin",{"_33":3020,"_35":13734,"_37":2110,"_39":13735,"_63":13736,"_65":13737,"_67":66},"mpmqKQUV",{"_2719":243},[],"Priority 1: Add Resource Hints (HIGH IMPACT, LOW EFFORT)",{"_29":13739,"_31":13871},[13740,13755,13766,13805,13843,13853,13860],{"_29":13741,"_31":13742},[],{"_33":2680,"_35":13743,"_37":2110,"_39":13744,"_63":13745,"_65":13754,"_67":66},"9E3MGmKf",{},[13746,13750],{"_33":3084,"_2788":13747,"_2790":13748,"_39":13749,"_67":66},[144,2920],[1835,2817],{},{"_33":2751,"_2788":13751,"_2790":13752,"_39":13753,"_67":66},[649],[6837],{},"File: frontend/apps/web/app/loaders.ts Lines to modify: 381-419",{"_29":13756,"_31":13757},[],{"_33":2680,"_35":13758,"_37":2110,"_39":13759,"_63":13760,"_65":13765,"_67":66},"PB2jgq86",{},[13761],{"_33":3084,"_2788":13762,"_2790":13763,"_39":13764,"_67":66},[144],[1057],{},"Strategy: Separate blocking vs non-blocking prefetches",{"_29":13767,"_31":13796},[13768,13775,13782,13789],{"_29":13769,"_31":13770},[],{"_33":2680,"_35":13771,"_37":2110,"_39":13772,"_63":13773,"_65":13774,"_67":66},"hZaVAN9n",{},[],"Home document",{"_29":13776,"_31":13777},[],{"_33":2680,"_35":13778,"_37":2110,"_39":13779,"_63":13780,"_65":13781,"_67":66},"RYDpSd_Q",{},[],"Home directory (for navigation)",{"_29":13783,"_31":13784},[],{"_33":2680,"_35":13785,"_37":2110,"_39":13786,"_63":13787,"_65":13788,"_67":66},"5uRT-kXJ",{},[],"Document directory (for children)",{"_29":13790,"_31":13791},[],{"_33":2680,"_35":13792,"_37":2110,"_39":13793,"_63":13794,"_65":13795,"_67":66},"M5UAaScs",{},[],"Authors",{"_33":2680,"_35":13797,"_37":2110,"_39":13798,"_63":13799,"_65":13804,"_67":66},"nux9PDwm",{"_2719":2972},[13800],{"_33":3084,"_2788":13801,"_2790":13802,"_39":13803,"_67":66},[144],[6567],{},"Critical (must complete before response):",{"_29":13806,"_31":13834},[13807,13814,13820,13827],{"_29":13808,"_31":13809},[],{"_33":2680,"_35":13810,"_37":2110,"_39":13811,"_63":13812,"_65":13813,"_67":66},"NCA040qC",{},[],"Interaction summaries",{"_29":13815,"_31":13816},[],{"_33":2680,"_35":13817,"_37":2110,"_39":13818,"_63":13819,"_65":13638,"_67":66},"XYSepg9W",{},[],{"_29":13821,"_31":13822},[],{"_33":2680,"_35":13823,"_37":2110,"_39":13824,"_63":13825,"_65":13826,"_67":66},"DL2-Eqgs",{},[],"Query results",{"_29":13828,"_31":13829},[],{"_33":2680,"_35":13830,"_37":2110,"_39":13831,"_63":13832,"_65":13833,"_67":66},"OPE35GOt",{},[],"Account metadata",{"_33":2680,"_35":13835,"_37":2110,"_39":13836,"_63":13837,"_65":13842,"_67":66},"DWq3_ZnM",{"_2719":2972},[13838],{"_33":3084,"_2788":13839,"_2790":13840,"_39":13841,"_67":66},[144],[2792],{},"Non-Critical (can fail gracefully):",{"_29":13844,"_31":13845},[],{"_33":2680,"_35":13846,"_37":2110,"_39":13847,"_63":13848,"_65":13714,"_67":66},"IiZuqHjl",{},[13849],{"_33":3084,"_2788":13850,"_2790":13851,"_39":13852,"_67":66},[144],[912],{},{"_29":13854,"_31":13855},[],{"_33":2751,"_35":13856,"_37":2110,"_39":13857,"_63":13858,"_65":13859,"_67":66},"yV2PrmEw",{"_2753":13245},[],"// Prefetch CRITICAL data - must succeed\nawait instrument(ctx || noopCtx, 'prefetchCriticalData', async () => {\n await Promise.all([\n prefetchCtx.queryClient.prefetchQuery(queryResource(client, homeId)),\n prefetchCtx.queryClient.prefetchQuery(\n queryDirectory(client, homeId, 'Children'),\n ),\n prefetchCtx.queryClient.prefetchQuery(\n queryDirectory(client, docId, 'Children'),\n ),\n ])\n})\n\n// Prefetch NON-CRITICAL data - use allSettled for graceful degradation\nawait instrument(ctx || noopCtx, 'prefetchNonCriticalData', async () => {\n await Promise.allSettled([\n // Interaction summary - nice to have but not blocking\n prefetchCtx.queryClient.prefetchQuery(\n queryInteractionSummary(client, docId),\n ),\n // Embedded docs - will load on client if missing\n ...embeddedDocs.map((doc) =>\n prefetchCtx.queryClient.prefetchQuery(queryResource(client, doc.id)),\n ),\n // Account metadata - will load on client if missing\n ...authors.map((author) =>\n prefetchCtx.queryClient.prefetchQuery(\n queryAccount(client, author.id.uid),\n ),\n ),\n ])\n})\n",{"_29":13861,"_31":13862},[],{"_33":2680,"_35":13863,"_37":2110,"_39":13864,"_63":13865,"_65":13870,"_67":66},"WtFfBuZf",{},[13866],{"_33":3084,"_2788":13867,"_2790":13868,"_39":13869,"_67":66},[144],[2551],{},"Expected improvement: 200-500ms faster TTFB (Time To First Byte)",{"_33":3020,"_35":13872,"_37":2110,"_39":13873,"_63":13874,"_65":13875,"_67":66},"31p5-uvB",{"_2719":243},[],"Priority 2: Split Critical vs Non-Critical Prefetching (HIGH IMPACT, MEDIUM EFFORT)",{"_29":13877,"_31":13954},[13878,13893,13904,13911,13943],{"_29":13879,"_31":13880},[],{"_33":2680,"_35":13881,"_37":2110,"_39":13882,"_63":13883,"_65":13892,"_67":66},"7GMviTqC",{},[13884,13888],{"_33":3084,"_2788":13885,"_2790":13886,"_39":13887,"_67":66},[144,783],[1835,6240],{},{"_33":2751,"_2788":13889,"_2790":13890,"_39":13891,"_67":66},[649],[8222],{},"File: frontend/apps/web/app/providers.tsx Lines to modify: 38-49",{"_29":13894,"_31":13895},[],{"_33":2680,"_35":13896,"_37":2110,"_39":13897,"_63":13898,"_65":13903,"_67":66},"pMT54rgL",{},[13899],{"_33":3084,"_2788":13900,"_2790":13901,"_39":13902,"_67":66},[144],[649],{},"Change:",{"_29":13905,"_31":13906},[],{"_33":2751,"_35":13907,"_37":2110,"_39":13908,"_63":13909,"_65":13910,"_67":66},"l8LubfIu",{"_2753":13245},[],"function createQueryClient() {\n return new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: 60000, // 1 minute (was Infinity)\n refetchOnMount: false,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n },\n },\n })\n}\n",{"_29":13912,"_31":13934},[13913,13920,13927],{"_29":13914,"_31":13915},[],{"_33":2680,"_35":13916,"_37":2110,"_39":13917,"_63":13918,"_65":13919,"_67":66},"av06yEfd",{},[],"Keeps SSR cache benefits (no refetch on mount/focus)",{"_29":13921,"_31":13922},[],{"_33":2680,"_35":13923,"_37":2110,"_39":13924,"_63":13925,"_65":13926,"_67":66},"oVJadrRl",{},[],"Allows background freshness checks after 1 minute",{"_29":13928,"_31":13929},[],{"_33":2680,"_35":13930,"_37":2110,"_39":13931,"_63":13932,"_65":13933,"_67":66},"h07I49sT",{},[],"Balances performance with data freshness",{"_33":2680,"_35":13935,"_37":2110,"_39":13936,"_63":13937,"_65":13942,"_67":66},"U1pLIQEV",{"_2719":2972},[13938],{"_33":3084,"_2788":13939,"_2790":13940,"_39":13941,"_67":66},[144],[2905],{},"Rationale:",{"_29":13944,"_31":13945},[],{"_33":2680,"_35":13946,"_37":2110,"_39":13947,"_63":13948,"_65":13953,"_67":66},"eVLi4PxC",{},[13949],{"_33":3084,"_2788":13950,"_2790":13951,"_39":13952,"_67":66},[144],[2551],{},"Expected improvement: Better long-session UX, minimal performance impact",{"_33":3020,"_35":13955,"_37":2110,"_39":13956,"_63":13957,"_65":13958,"_67":66},"SH6oWMzY",{"_2719":243},[],"Priority 3: Tune React Query staleTime (LOW IMPACT, LOW EFFORT)",{"_29":13960,"_31":14066},[13961,13976,13987,13997,14004,14044,14055],{"_29":13962,"_31":13963},[],{"_33":2680,"_35":13964,"_37":2110,"_39":13965,"_63":13966,"_65":13975,"_67":66},"bfQzKbaG",{},[13967,13971],{"_33":3084,"_2788":13968,"_2790":13969,"_39":13970,"_67":66},[144,8222],[1835,6287],{},{"_33":2751,"_2788":13972,"_2790":13973,"_39":13974,"_67":66},[649],[6567],{},"File: frontend/apps/web/app/routes/$.tsx Lines to modify: 155-236",{"_29":13977,"_31":13978},[],{"_33":2680,"_35":13979,"_37":2110,"_39":13980,"_63":13981,"_65":13986,"_67":66},"_U34UkGL",{},[13982],{"_33":3084,"_2788":13983,"_2790":13984,"_39":13985,"_67":66},[144],[1057],{},"Strategy: Split loader into critical shell data + deferred streaming data",{"_29":13988,"_31":13989},[],{"_33":2680,"_35":13990,"_37":2110,"_39":13991,"_63":13992,"_65":13714,"_67":66},"FwgjJRLf",{},[13993],{"_33":3084,"_2788":13994,"_2790":13995,"_39":13996,"_67":66},[144],[912],{},{"_29":13998,"_31":13999},[],{"_33":2751,"_35":14000,"_37":2110,"_39":14001,"_63":14002,"_65":14003,"_67":66},"WMVFvaEt",{"_2753":13245},[],"import {defer} from '@remix-run/node'\n\nexport const loader = async ({params, request}) => {\n const parsedRequest = parseRequest(request)\n const documentId = unpackHmId(params['*'])\n\n if (!useFullRender(parsedRequest)) {\n return null\n }\n\n const serviceConfig = await getConfig(hostname)\n\n // Load CRITICAL data (blocks shell render)\n const criticalData = await loadCriticalSiteResource(parsedRequest, documentId)\n\n // Start loading NON-CRITICAL data (streams after shell)\n const deferredData = {\n interactionSummary: loadInteractionSummary(documentId),\n embeddedDocs: loadEmbeddedDocuments(documentId),\n }\n\n return defer({\n ...criticalData,\n ...deferredData,\n })\n}\n",{"_29":14005,"_31":14035},[14006,14017,14028],{"_29":14007,"_31":14008},[],{"_33":2680,"_35":14009,"_37":2110,"_39":14010,"_63":14011,"_65":14016,"_67":66},"msDBbPCc",{},[14012],{"_33":2751,"_2788":14013,"_2790":14014,"_39":14015,"_67":66},[2866],[783],{},"Wrap non-critical components in ",{"_29":14018,"_31":14019},[],{"_33":2680,"_35":14020,"_37":2110,"_39":14021,"_63":14022,"_65":14027,"_67":66},"jSUWE5h6",{},[14023],{"_33":2751,"_2788":14024,"_2790":14025,"_39":14026,"_67":66},[1835],[1300],{},"Use component for deferred data",{"_29":14029,"_31":14030},[],{"_33":2680,"_35":14031,"_37":2110,"_39":14032,"_63":14033,"_65":14034,"_67":66},"y1fOFGw8",{},[],"Add loading states for streaming sections",{"_33":2680,"_35":14036,"_37":2110,"_39":14037,"_63":14038,"_65":14043,"_67":66},"A5gD_YuB",{"_2719":2972},[14039],{"_33":3084,"_2788":14040,"_2790":14041,"_39":14042,"_67":66},[144],[2839],{},"UI Changes Required:",{"_29":14045,"_31":14046},[],{"_33":2680,"_35":14047,"_37":2110,"_39":14048,"_63":14049,"_65":14054,"_67":66},"Mrt9vw2U",{},[14050],{"_33":3084,"_2788":14051,"_2790":14052,"_39":14053,"_67":66},[144],[2551],{},"Expected improvement: 300-600ms faster perceived load time",{"_29":14056,"_31":14057},[],{"_33":2680,"_35":14058,"_37":2110,"_39":14059,"_63":14060,"_65":14065,"_67":66},"-_Q1T0L9",{},[14061],{"_33":3084,"_2788":14062,"_2790":14063,"_39":14064,"_67":66},[144],[1835],{},"Note: This is the most complex change and should be considered for a future iteration if simpler optimizations don't provide sufficient gains.",{"_33":3020,"_35":14067,"_37":2110,"_39":14068,"_63":14069,"_65":14070,"_67":66},"1CRWZ_d5",{"_2719":243},[],"Priority 4: Implement defer() for Streaming (MEDIUM IMPACT, HIGH EFFORT)",{"_33":3020,"_35":14072,"_37":2110,"_39":14073,"_63":14074,"_65":14075,"_67":66},"Ql8XVDc-",{"_2719":243},[],"Optimization Roadmap",{"_29":14077,"_31":14442},[14078,14288],{"_29":14079,"_31":14283},[14080,14130,14187,14230],{"_29":14081,"_31":14121},[14082,14093,14100,14107,14114],{"_29":14083,"_31":14084},[],{"_33":2680,"_35":14085,"_37":2110,"_39":14086,"_63":14087,"_65":14092,"_67":66},"2V5SWRz9",{},[14088],{"_33":2751,"_2788":14089,"_2790":14090,"_39":14091,"_67":66},[1300],[8222],{},"[ ] Update frontend/apps/web/app/root.tsx links export",{"_29":14094,"_31":14095},[],{"_33":2680,"_35":14096,"_37":2110,"_39":14097,"_63":14098,"_65":14099,"_67":66},"2nSkSpE7",{},[],"[ ] Add preconnect for DAEMON_HTTP_URL/SEED_ASSET_HOST",{"_29":14101,"_31":14102},[],{"_33":2680,"_35":14103,"_37":2110,"_39":14104,"_63":14105,"_65":14106,"_67":66},"NC5UhmFp",{},[],"[ ] Add dns-prefetch for LIGHTNING_API_URL",{"_29":14108,"_31":14109},[],{"_33":2680,"_35":14110,"_37":2110,"_39":14111,"_63":14112,"_65":14113,"_67":66},"C4ti85z_",{},[],"[ ] Add dns-prefetch for NOTIFY_SERVICE_HOST (if configured)",{"_29":14115,"_31":14116},[],{"_33":2680,"_35":14117,"_37":2110,"_39":14118,"_63":14119,"_65":14120,"_67":66},"aQffYhyK",{},[],"[ ] Test in production mode (resource hints only work in production)",{"_33":2680,"_35":14122,"_37":2110,"_39":14123,"_63":14124,"_65":14129,"_67":66},"vReQTOY1",{"_2719":2972},[14125],{"_33":3084,"_2788":14126,"_2790":14127,"_39":14128,"_67":66},[1835],[2836],{},"[ ] Add Resource Hints",{"_29":14131,"_31":14178},[14132,14143,14150,14157,14164,14171],{"_29":14133,"_31":14134},[],{"_33":2680,"_35":14135,"_37":2110,"_39":14136,"_63":14137,"_65":14142,"_67":66},"Z7txlWgJ",{},[14138],{"_33":2751,"_2788":14139,"_2790":14140,"_39":14141,"_67":66},[1300],[2966],{},"[ ] Update frontend/apps/web/app/loaders.ts prefetch logic",{"_29":14144,"_31":14145},[],{"_33":2680,"_35":14146,"_37":2110,"_39":14147,"_63":14148,"_65":14149,"_67":66},"S0AH1gFz",{},[],"[ ] Separate critical Promise.all from non-critical Promise.allSettled",{"_29":14151,"_31":14152},[],{"_33":2680,"_35":14153,"_37":2110,"_39":14154,"_63":14155,"_65":14156,"_67":66},"rKWXUq92",{},[],"[ ] Move interaction summary to non-critical section",{"_29":14158,"_31":14159},[],{"_33":2680,"_35":14160,"_37":2110,"_39":14161,"_63":14162,"_65":14163,"_67":66},"lDtv4-gq",{},[],"[ ] Move embedded docs to non-critical section",{"_29":14165,"_31":14166},[],{"_33":2680,"_35":14167,"_37":2110,"_39":14168,"_63":14169,"_65":14170,"_67":66},"_4N6vmWt",{},[],"[ ] Move account metadata to non-critical section",{"_29":14172,"_31":14173},[],{"_33":2680,"_35":14174,"_37":2110,"_39":14175,"_63":14176,"_65":14177,"_67":66},"GVtFSSX9",{},[],"[ ] Add instrumentation tags for monitoring",{"_33":2680,"_35":14179,"_37":2110,"_39":14180,"_63":14181,"_65":14186,"_67":66},"LF9wNJR-",{"_2719":2972},[14182],{"_33":3084,"_2788":14183,"_2790":14184,"_39":14185,"_67":66},[1835],[2907],{},"[ ] Split Prefetching",{"_29":14188,"_31":14221},[14189,14200,14207,14214],{"_29":14190,"_31":14191},[],{"_33":2680,"_35":14192,"_37":2110,"_39":14193,"_63":14194,"_65":14199,"_67":66},"csWOBpUm",{},[14195],{"_33":2751,"_2788":14196,"_2790":14197,"_39":14198,"_67":66},[1300],[2822],{},"[ ] Update frontend/apps/web/app/providers.tsx",{"_29":14201,"_31":14202},[],{"_33":2680,"_35":14203,"_37":2110,"_39":14204,"_63":14205,"_65":14206,"_67":66},"tj-zFGUW",{},[],"[ ] Change staleTime from Infinity to 60000",{"_29":14208,"_31":14209},[],{"_33":2680,"_35":14210,"_37":2110,"_39":14211,"_63":14212,"_65":14213,"_67":66},"M4vK_gOZ",{},[],"[ ] Verify refetch behavior is correct",{"_29":14215,"_31":14216},[],{"_33":2680,"_35":14217,"_37":2110,"_39":14218,"_63":14219,"_65":14220,"_67":66},"4aIUWVlG",{},[],"[ ] Test client-side navigation still uses cache",{"_33":2680,"_35":14222,"_37":2110,"_39":14223,"_63":14224,"_65":14229,"_67":66},"sY9EE4pL",{"_2719":2972},[14225],{"_33":3084,"_2788":14226,"_2790":14227,"_39":14228,"_67":66},[1835],[2551],{},"[ ] Tune React Query",{"_29":14231,"_31":14274},[14232,14239,14246,14253,14260,14267],{"_29":14233,"_31":14234},[],{"_33":2680,"_35":14235,"_37":2110,"_39":14236,"_63":14237,"_65":14238,"_67":66},"62qAvtmk",{},[],"[ ] Create separate loader functions for critical vs deferred",{"_29":14240,"_31":14241},[],{"_33":2680,"_35":14242,"_37":2110,"_39":14243,"_63":14244,"_65":14245,"_67":66},"aowjTQ13",{},[],"[ ] Update route to use defer()",{"_29":14247,"_31":14248},[],{"_33":2680,"_35":14249,"_37":2110,"_39":14250,"_63":14251,"_65":14252,"_67":66},"OCEw3cF6",{},[],"[ ] Add Suspense boundaries in UI",{"_29":14254,"_31":14255},[],{"_33":2680,"_35":14256,"_37":2110,"_39":14257,"_63":14258,"_65":14259,"_67":66},"6wrqNIu5",{},[],"[ ] Add Await components for deferred data",{"_29":14261,"_31":14262},[],{"_33":2680,"_35":14263,"_37":2110,"_39":14264,"_63":14265,"_65":14266,"_67":66},"9E005_ID",{},[],"[ ] Add loading states",{"_29":14268,"_31":14269},[],{"_33":2680,"_35":14270,"_37":2110,"_39":14271,"_63":14272,"_65":14273,"_67":66},"vnvMR73b",{},[],"[ ] Test streaming behavior",{"_33":2680,"_35":14275,"_37":2110,"_39":14276,"_63":14277,"_65":14282,"_67":66},"xL_8csfj",{"_2719":2972},[14278],{"_33":3084,"_2788":14279,"_2790":14280,"_39":14281,"_67":66},[1835],[2866],{},"[ ] (Optional) Implement defer()",{"_33":3020,"_35":14284,"_37":2110,"_39":14285,"_63":14286,"_65":14287,"_67":66},"ZGA4W6tY",{"_2719":2972},[],"Phase 2 Tasks",{"_29":14289,"_31":14437},[14290,14340,14386],{"_29":14291,"_31":14331},[14292,14303,14310,14317,14324],{"_29":14293,"_31":14294},[],{"_33":2680,"_35":14295,"_37":2110,"_39":14296,"_63":14297,"_65":14302,"_67":66},"z2BWVT5y",{},[14298],{"_33":2751,"_2788":14299,"_2790":14300,"_39":14301,"_67":66},[1057],[1182],{},"[ ] Run yarn web and verify app loads",{"_29":14304,"_31":14305},[],{"_33":2680,"_35":14306,"_37":2110,"_39":14307,"_63":14308,"_65":14309,"_67":66},"VTjJTHUH",{},[],"[ ] Test pages with Query blocks",{"_29":14311,"_31":14312},[],{"_33":2680,"_35":14313,"_37":2110,"_39":14314,"_63":14315,"_65":14316,"_67":66},"pLiAoU3G",{},[],"[ ] Test client-side navigation",{"_29":14318,"_31":14319},[],{"_33":2680,"_35":14320,"_37":2110,"_39":14321,"_63":14322,"_65":14323,"_67":66},"pX9--qBU",{},[],"[ ] Verify no console errors",{"_29":14325,"_31":14326},[],{"_33":2680,"_35":14327,"_37":2110,"_39":14328,"_63":14329,"_65":14330,"_67":66},"ailcy7ri",{},[],"[ ] Check Network tab for resource hint effects",{"_33":2680,"_35":14332,"_37":2110,"_39":14333,"_63":14334,"_65":14339,"_67":66},"2ScAk36v",{"_2719":2972},[14335],{"_33":3084,"_2788":14336,"_2790":14337,"_39":14338,"_67":66},[1835],[8172],{},"[ ] Development Testing",{"_29":14341,"_31":14377},[14342,14349,14356,14363,14370],{"_29":14343,"_31":14344},[],{"_33":2680,"_35":14345,"_37":2110,"_39":14346,"_63":14347,"_65":14348,"_67":66},"vcLmgXk5",{},[],"[ ] Measure TTFB before/after",{"_29":14350,"_31":14351},[],{"_33":2680,"_35":14352,"_37":2110,"_39":14353,"_63":14354,"_65":14355,"_67":66},"9BHApTtB",{},[],"[ ] Measure FCP (First Contentful Paint)",{"_29":14357,"_31":14358},[],{"_33":2680,"_35":14359,"_37":2110,"_39":14360,"_63":14361,"_65":14362,"_67":66},"rK0xLoPH",{},[],"[ ] Measure LCP (Largest Contentful Paint)",{"_29":14364,"_31":14365},[],{"_33":2680,"_35":14366,"_37":2110,"_39":14367,"_63":14368,"_65":14369,"_67":66},"ohn1JInI",{},[],"[ ] Measure TTI (Time To Interactive)",{"_29":14371,"_31":14372},[],{"_33":2680,"_35":14373,"_37":2110,"_39":14374,"_63":14375,"_65":14376,"_67":66},"QrDgEinM",{},[],"[ ] Test on slow 3G network simulation",{"_33":2680,"_35":14378,"_37":2110,"_39":14379,"_63":14380,"_65":14385,"_67":66},"BKjmI4WQ",{"_2719":2972},[14381],{"_33":3084,"_2788":14382,"_2790":14383,"_39":14384,"_67":66},[1835],[8172],{},"[ ] Performance Testing",{"_29":14387,"_31":14428},[14388,14399,14406,14417],{"_29":14389,"_31":14390},[],{"_33":2680,"_35":14391,"_37":2110,"_39":14392,"_63":14393,"_65":14398,"_67":66},"3P8rJAi6",{},[14394],{"_33":2751,"_2788":14395,"_2790":14396,"_39":14397,"_67":66},[1057],[2907],{},"[ ] Run yarn web:test",{"_29":14400,"_31":14401},[],{"_33":2680,"_35":14402,"_37":2110,"_39":14403,"_63":14404,"_65":14405,"_67":66},"OB7T21hN",{},[],"[ ] Verify all tests pass",{"_29":14407,"_31":14408},[],{"_33":2680,"_35":14409,"_37":2110,"_39":14410,"_63":14411,"_65":14416,"_67":66},"rTzmcI1e",{},[14412],{"_33":2751,"_2788":14413,"_2790":14414,"_39":14415,"_67":66},[2839],[6695],{},"[ ] Run typecheck: yarn typecheck",{"_29":14418,"_31":14419},[],{"_33":2680,"_35":14420,"_37":2110,"_39":14421,"_63":14422,"_65":14427,"_67":66},"OrXdHaCN",{},[14423],{"_33":2751,"_2788":14424,"_2790":14425,"_39":14426,"_67":66},[2836],[2920],{},"[ ] Run format check: yarn format:check",{"_33":2680,"_35":14429,"_37":2110,"_39":14430,"_63":14431,"_65":14436,"_67":66},"P-2GUYnC",{"_2719":2972},[14432],{"_33":3084,"_2788":14433,"_2790":14434,"_39":14435,"_67":66},[1835],[8172],{},"[ ] Integration Testing",{"_33":3020,"_35":14438,"_37":2110,"_39":14439,"_63":14440,"_65":14441,"_67":66},"3rR8eqp8",{"_2719":2972},[],"Testing",{"_33":3020,"_35":14443,"_37":2110,"_39":14444,"_63":14445,"_65":14446,"_67":66},"-0AFA8z1",{"_2719":243},[],"Implementation Checklist",{"_29":14448,"_31":14538},[14449,14481,14513],{"_29":14450,"_31":14476},[14451,14458,14465],{"_29":14452,"_31":14453},[],{"_33":2680,"_35":14454,"_37":2110,"_39":14455,"_63":14456,"_65":14457,"_67":66},"t-CmfyHD",{},[],"Resource hints: -150ms connection overhead",{"_29":14459,"_31":14460},[],{"_33":2680,"_35":14461,"_37":2110,"_39":14462,"_63":14463,"_65":14464,"_67":66},"adUQROK9",{},[],"Split prefetching: -400ms TTFB",{"_29":14466,"_31":14467},[],{"_33":2680,"_35":14468,"_37":2110,"_39":14469,"_63":14470,"_65":14475,"_67":66},"7eOuxHfs",{},[14471],{"_33":3084,"_2788":14472,"_2790":14473,"_39":14474,"_67":66},[7514],[6571],{},"Combined: ~550ms faster first paint",{"_33":3020,"_35":14477,"_37":2110,"_39":14478,"_63":14479,"_65":14480,"_67":66},"DoIYWRXi",{"_2719":2972},[],"Optimistic Scenario",{"_29":14482,"_31":14508},[14483,14490,14497],{"_29":14484,"_31":14485},[],{"_33":2680,"_35":14486,"_37":2110,"_39":14487,"_63":14488,"_65":14489,"_67":66},"Yf1qdYdx",{},[],"Resource hints: -100ms connection overhead",{"_29":14491,"_31":14492},[],{"_33":2680,"_35":14493,"_37":2110,"_39":14494,"_63":14495,"_65":14496,"_67":66},"KEAvBhN3",{},[],"Split prefetching: -200ms TTFB",{"_29":14498,"_31":14499},[],{"_33":2680,"_35":14500,"_37":2110,"_39":14501,"_63":14502,"_65":14507,"_67":66},"aLr-TaB9",{},[14503],{"_33":3084,"_2788":14504,"_2790":14505,"_39":14506,"_67":66},[7514],[6571],{},"Combined: ~300ms faster first paint",{"_33":3020,"_35":14509,"_37":2110,"_39":14510,"_63":14511,"_65":14512,"_67":66},"mR2IBsOR",{"_2719":2972},[],"Conservative Scenario",{"_29":14514,"_31":14533},[14515,14522],{"_29":14516,"_31":14517},[],{"_33":2680,"_35":14518,"_37":2110,"_39":14519,"_63":14520,"_65":14521,"_67":66},"z1GdIaZj",{},[],"Additional: -300ms perceived load time",{"_29":14523,"_31":14524},[],{"_33":2680,"_35":14525,"_37":2110,"_39":14526,"_63":14527,"_65":14532,"_67":66},"z6mNP8zh",{},[14528],{"_33":3084,"_2788":14529,"_2790":14530,"_39":14531,"_67":66},[144],[4245],{},"Total: ~600-850ms improvement",{"_33":3020,"_35":14534,"_37":2110,"_39":14535,"_63":14536,"_65":14537,"_67":66},"UQaqbMMl",{"_2719":2972},[],"With defer() (future)",{"_33":3020,"_35":14539,"_37":2110,"_39":14540,"_63":14541,"_65":14542,"_67":66},"x3lJ3SES",{"_2719":243},[],"Expected Performance Gains",{"_29":14544,"_31":14690},[14545,14655],{"_29":14546,"_31":14650},[14547,14579,14618],{"_29":14548,"_31":14570},[14549,14556,14563],{"_29":14550,"_31":14551},[],{"_33":2680,"_35":14552,"_37":2110,"_39":14553,"_63":14554,"_65":14555,"_67":66},"VEdlvAF9",{},[],"TTFB (Time To First Byte)",{"_29":14557,"_31":14558},[],{"_33":2680,"_35":14559,"_37":2110,"_39":14560,"_63":14561,"_65":14562,"_67":66},"impS9HRb",{},[],"Server processing time",{"_29":14564,"_31":14565},[],{"_33":2680,"_35":14566,"_37":2110,"_39":14567,"_63":14568,"_65":14569,"_67":66},"4XGK3E1r",{},[],"Prefetch operation duration (instrumentation)",{"_33":2680,"_35":14571,"_37":2110,"_39":14572,"_63":14573,"_65":14578,"_67":66},"SJwrf7xA",{"_2719":2972},[14574],{"_33":3084,"_2788":14575,"_2790":14576,"_39":14577,"_67":66},[144],[1300],{},"Server-Side:",{"_29":14580,"_31":14609},[14581,14588,14595,14602],{"_29":14582,"_31":14583},[],{"_33":2680,"_35":14584,"_37":2110,"_39":14585,"_63":14586,"_65":14587,"_67":66},"JiL-Vd_u",{},[],"FCP (First Contentful Paint)",{"_29":14589,"_31":14590},[],{"_33":2680,"_35":14591,"_37":2110,"_39":14592,"_63":14593,"_65":14594,"_67":66},"t1EiUgQa",{},[],"LCP (Largest Contentful Paint)",{"_29":14596,"_31":14597},[],{"_33":2680,"_35":14598,"_37":2110,"_39":14599,"_63":14600,"_65":14601,"_67":66},"ka04v_n9",{},[],"TTI (Time To Interactive)",{"_29":14603,"_31":14604},[],{"_33":2680,"_35":14605,"_37":2110,"_39":14606,"_63":14607,"_65":14608,"_67":66},"7A_wBIaj",{},[],"Total Blocking Time",{"_33":2680,"_35":14610,"_37":2110,"_39":14611,"_63":14612,"_65":14617,"_67":66},"bxralLPr",{"_2719":2972},[14613],{"_33":3084,"_2788":14614,"_2790":14615,"_39":14616,"_67":66},[144],[1300],{},"Client-Side:",{"_29":14619,"_31":14641},[14620,14627,14634],{"_29":14621,"_31":14622},[],{"_33":2680,"_35":14623,"_37":2110,"_39":14624,"_63":14625,"_65":14626,"_67":66},"4TE92j3V",{},[],"Perceived load speed",{"_29":14628,"_31":14629},[],{"_33":2680,"_35":14630,"_37":2110,"_39":14631,"_63":14632,"_65":14633,"_67":66},"a-s62LJP",{},[],"Client-side navigation smoothness",{"_29":14635,"_31":14636},[],{"_33":2680,"_35":14637,"_37":2110,"_39":14638,"_63":14639,"_65":14640,"_67":66},"NczcTdsf",{},[],"Cache hit rates",{"_33":2680,"_35":14642,"_37":2110,"_39":14643,"_63":14644,"_65":14649,"_67":66},"rfmLBgHM",{"_2719":2972},[14645],{"_33":3084,"_2788":14646,"_2790":14647,"_39":14648,"_67":66},[144],[2087],{},"User Experience:",{"_33":3020,"_35":14651,"_37":2110,"_39":14652,"_63":14653,"_65":14654,"_67":66},"xWuFMBxu",{"_2719":243},[],"Metrics to Track",{"_29":14656,"_31":14685},[14657,14664,14671,14678],{"_29":14658,"_31":14659},[],{"_33":2680,"_35":14660,"_37":2110,"_39":14661,"_63":14662,"_65":14663,"_67":66},"oVOGnuzf",{},[],"Chrome DevTools Network/Performance tabs",{"_29":14665,"_31":14666},[],{"_33":2680,"_35":14667,"_37":2110,"_39":14668,"_63":14669,"_65":14670,"_67":66},"6XrmGA8Y",{},[],"Lighthouse CI",{"_29":14672,"_31":14673},[],{"_33":2680,"_35":14674,"_37":2110,"_39":14675,"_63":14676,"_65":14677,"_67":66},"vIX-Mksq",{},[],"WebPageTest",{"_29":14679,"_31":14680},[],{"_33":2680,"_35":14681,"_37":2110,"_39":14682,"_63":14683,"_65":14684,"_67":66},"be8OyeP3",{},[],"Custom instrumentation (already in place)",{"_33":3020,"_35":14686,"_37":2110,"_39":14687,"_63":14688,"_65":14689,"_67":66},"cfCfIbxC",{"_2719":2972},[],"Tools",{"_33":3020,"_35":14691,"_37":2110,"_39":14692,"_63":14693,"_65":14694,"_67":66},"g7DCmvPR",{"_2719":243},[],"Monitoring & Validation",{"_29":14696,"_31":14755},[14697,14748],{"_29":14698,"_31":14743},[14699,14710,14721,14732],{"_29":14700,"_31":14701},[],{"_33":2680,"_35":14702,"_37":2110,"_39":14703,"_63":14704,"_65":14709,"_67":66},"pEYHD9-G",{},[14705],{"_33":3084,"_2788":14706,"_2790":14707,"_39":14708,"_67":66},[144],[912],{},"Resource Hints: Remove from links export (low risk)",{"_29":14711,"_31":14712},[],{"_33":2680,"_35":14713,"_37":2110,"_39":14714,"_63":14715,"_65":14720,"_67":66},"8CLSm82e",{},[14716],{"_33":3084,"_2788":14717,"_2790":14718,"_39":14719,"_67":66},[144],[2821],{},"Split Prefetching: Revert to single Promise.all (medium risk)",{"_29":14722,"_31":14723},[],{"_33":2680,"_35":14724,"_37":2110,"_39":14725,"_63":14726,"_65":14731,"_67":66},"TJ2RA4e2",{},[14727],{"_33":3084,"_2788":14728,"_2790":14729,"_39":14730,"_67":66},[144],[2905],{},"staleTime: Revert to Infinity (low risk)",{"_29":14733,"_31":14734},[],{"_33":2680,"_35":14735,"_37":2110,"_39":14736,"_63":14737,"_65":14742,"_67":66},"9mIyUZZs",{},[14738],{"_33":3084,"_2788":14739,"_2790":14740,"_39":14741,"_67":66},[144],[882],{},"defer(): Remove defer, return to blocking loader (high risk if implemented)",{"_33":2680,"_35":14744,"_37":2110,"_39":14745,"_63":14746,"_65":14747,"_67":66},"54Ch84Io",{"_2719":3238},[],"If optimizations cause issues:",{"_29":14749,"_31":14750},[],{"_33":2680,"_35":14751,"_37":2110,"_39":14752,"_63":14753,"_65":14754,"_67":66},"QAaHj2on",{},[],"All changes are independent and can be reverted individually.",{"_33":3020,"_35":14756,"_37":2110,"_39":14757,"_63":14758,"_65":14759,"_67":66},"INR3L8PE",{"_2719":243},[],"Rollback Plan",{"_29":14761,"_31":14810},[14762,14774,14786,14798],{"_29":14763,"_31":14764},[],{"_33":2680,"_35":14765,"_37":2110,"_39":14766,"_63":14767,"_65":14773,"_67":66},"__XrSbmi",{},[14768],{"_33":204,"_2788":14769,"_2790":14770,"_39":14771,"_67":14772},[2551],[6919],{},"https://remix.run/docs/en/main/guides/streaming","Remix defer() docs: https://remix.run/docs/en/main/guides/streaming",{"_29":14775,"_31":14776},[],{"_33":2680,"_35":14777,"_37":2110,"_39":14778,"_63":14779,"_65":14785,"_67":66},"FdZYmD3O",{},[14780],{"_33":204,"_2788":14781,"_2790":14782,"_39":14783,"_67":14784},[2821],[6386],{},"https://tanstack.com/query/latest/docs/react/guides/ssr","React Query SSR: https://tanstack.com/query/latest/docs/react/guides/ssr",{"_29":14787,"_31":14788},[],{"_33":2680,"_35":14789,"_37":2110,"_39":14790,"_63":14791,"_65":14797,"_67":66},"QXSiv8QL",{},[14792],{"_33":204,"_2788":14793,"_2790":14794,"_39":14795,"_67":14796},[1182],[6572],{},"https://www.w3.org/TR/resource-hints/","Resource Hints: https://www.w3.org/TR/resource-hints/",{"_29":14799,"_31":14800},[],{"_33":2680,"_35":14801,"_37":2110,"_39":14802,"_63":14803,"_65":14809,"_67":66},"eooFPVc8",{},[14804],{"_33":204,"_2788":14805,"_2790":14806,"_39":14807,"_67":14808},[2821],[6567],{},"https://web.dev/vitals/","Core Web Vitals: https://web.dev/vitals/",{"_33":3020,"_35":14811,"_37":2110,"_39":14812,"_63":14813,"_65":14814,"_67":66},"DLYgmDHb",{"_2719":2972},[],"References",[76],"/tech-talks/ssr-performance-optimization-plan","2025-12-19T13:27:08.495Z",{"_84":2123,"_86":2124},{},{"_90":2110,"_94":2121},{"_35":2097,"_102":51,"_52":14822,"_68":2100,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2099],1779255260621,[156,2097,2100,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/ssr-performance-optimization-plan\",\"bafy2bzacedf5krbv3qsoly6f2t65bu5dmpsoepkkhiy5xcvcoclezzmu7sqdm\",true]",{"_117":14827,"_154":15307,"_157":15308},{"_119":14828,"_139":42,"_140":15306,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":14829,"_35":15304},{"_26":14830,"_68":2130,"_69":51,"_70":15298,"_52":15299,"_78":2139,"_80":15300,"_82":15301,"_88":15302,"_90":2140,"_92":15303,"_96":97},[14831,14841,14883,14939],{"_29":14832,"_31":14833},[],{"_33":2680,"_35":14834,"_37":2130,"_39":14835,"_63":14836,"_65":2150,"_67":66},"QUzEBqra",{},[14837],{"_33":204,"_2788":14838,"_2790":14839,"_39":14840,"_67":2150},[144],[6804],{},{"_29":14842,"_31":14878},[14843,14850,14864],{"_29":14844,"_31":14845},[],{"_33":2680,"_35":14846,"_37":2140,"_39":14847,"_63":14848,"_65":14849,"_67":66},"Z1hw-uMI",{},[],"Currently, the server rendering is implemented in a very messy way, and in many cases it is just broken because we opted to simplify the code.",{"_29":14851,"_31":14859},[14852],{"_29":14853,"_31":14854},[],{"_33":2680,"_35":14855,"_37":2140,"_39":14856,"_63":14857,"_65":14858,"_67":66},"plLkJZBB",{},[],"todo: describe the situation on the web profile page when the name and photo is mutated.",{"_33":3020,"_35":14860,"_37":2140,"_39":14861,"_63":14862,"_65":14863,"_67":66},"9eu9oyZg",{"_2719":243},[],"When the client mutates a Resource that was server-rendered",{"_29":14865,"_31":14873},[14866],{"_29":14867,"_31":14868},[],{"_33":2680,"_35":14869,"_37":2140,"_39":14870,"_63":14871,"_65":14872,"_67":66},"e4WMuQWm",{},[],"todo: describe this mess",{"_33":3020,"_35":14874,"_37":2140,"_39":14875,"_63":14876,"_65":14877,"_67":66},"8CPXOMdj",{"_2719":243},[],"supportQueries and supportDocuments",{"_33":3020,"_35":14879,"_37":2140,"_39":14880,"_63":14881,"_65":14882,"_67":66},"Tzht2p5Q",{"_2719":243},[],"Current Pattern",{"_29":14884,"_31":14934},[14885,14892,14899],{"_29":14886,"_31":14887},[],{"_33":2680,"_35":14888,"_37":2140,"_39":14889,"_63":14890,"_65":14891,"_67":66},"wOClFZXP",{},[],"In the server render, we will explicitly decide what data to load, and pre-fill a ReactQuery cache. Every page will serialize the cache and pre-fill it in the same way.",{"_29":14893,"_31":14894},[],{"_33":2680,"_35":14895,"_37":2140,"_39":14896,"_63":14897,"_65":14898,"_67":66},"eGG7IRfI",{},[],"Now, the components inside the page can simply call the RQ hooks in the same way every time. In the server it will use the pre-filled cache. On the client's first render, it will use the cache that was passed down from the server",{"_29":14900,"_31":14929},[14901,14908,14915,14922],{"_29":14902,"_31":14903},[],{"_33":2680,"_35":14904,"_37":2140,"_39":14905,"_63":14906,"_65":14907,"_67":66},"exGHyI8M",{},[],"This means our components can be much simpler, because we will not need to explicitly hand down the server data through props and use some conflict resolution to decide when to use that compared to the RQ hooks. The code will be shorter, more consistent with desktop data loading code, and less buggy.",{"_29":14909,"_31":14910},[],{"_33":2680,"_35":14911,"_37":2140,"_39":14912,"_63":14913,"_65":14914,"_67":66},"7JZAk0x5",{},[],"If the server does not preload something, the client will load the data async using RQ when it wakes up.",{"_29":14916,"_31":14917},[],{"_33":2680,"_35":14918,"_37":2140,"_39":14919,"_63":14920,"_65":14921,"_67":66},"h7rxXW97",{},[],"If you decide that some more data should be loaded on the server, you can just add it to the server cache fill, without changing any client components.",{"_29":14923,"_31":14924},[],{"_33":2680,"_35":14925,"_37":2140,"_39":14926,"_63":14927,"_65":14928,"_67":66},"f-ZCjqbf",{},[],"This will avoid the confusing \"supportQueries\" and \"supportDocuments\" code which is very unpleasant to work with and has caused a lot of confusion on our team. This code was initially added to support server rendering, and the proposed pattern accomplishes the same thing in a less confusing way.",{"_33":3020,"_35":14930,"_37":2140,"_39":14931,"_63":14932,"_65":14933,"_67":66},"A7TT0XpG",{"_2719":243},[],"Benefit",{"_33":3020,"_35":14935,"_37":2140,"_39":14936,"_63":14937,"_65":14938,"_67":66},"DhqW8tub",{"_2719":243},[],"Proposed Solution",{"_29":14940,"_31":15293},[14941,15060,15067,15074,15081,15092,15099,15128,15161,15168,15175,15186,15193,15204,15278],{"_29":14942,"_31":15055},[14943,14992],{"_29":14944,"_31":14983},[14945,14956,14967],{"_29":14946,"_31":14947},[],{"_33":2680,"_35":14948,"_37":2140,"_39":14949,"_63":14950,"_65":14955,"_67":66},"eD_vnL8U",{},[14951],{"_33":2751,"_2788":14952,"_2790":14953,"_39":14954,"_67":66},[2905],[2551],{},"Create a QueryClient.",{"_29":14957,"_31":14958},[],{"_33":2680,"_35":14959,"_37":2140,"_39":14960,"_63":14961,"_65":14966,"_67":66},"I7A1XA9t",{},[14962],{"_33":2751,"_2788":14963,"_2790":14964,"_39":14965,"_67":66},[144,2821],[2805,6837],{},"prefetchQuery(or prefetchInfiniteQuery) for whatever you want ready.",{"_29":14968,"_31":14969},[],{"_33":2680,"_35":14970,"_37":2140,"_39":14971,"_63":14972,"_65":14982,"_67":66},"RdQGvJyX",{},[14973,14977],{"_33":2751,"_2788":14974,"_2790":14975,"_39":14976,"_67":66},[144],[2836],{},{"_33":204,"_2788":14978,"_2790":14979,"_39":14980,"_67":14981},[6695],[6567],{},"http://data.In","dehydrate(queryClient) and return that in the loader data.",{"_33":2680,"_35":14984,"_37":2140,"_39":14985,"_63":14986,"_65":14991,"_67":66},"BqyTd1Fq",{"_2719":2972},[14987],{"_33":3084,"_2788":14988,"_2790":14989,"_39":14990,"_67":66},[144],[2836],{},"On the server (loader)",{"_29":14993,"_31":15046},[14994,15005,15016,15027,15034],{"_29":14995,"_31":14996},[],{"_33":2680,"_35":14997,"_37":2140,"_39":14998,"_63":14999,"_65":15004,"_67":66},"yCT1UeSs",{},[15000],{"_33":2751,"_2788":15001,"_2790":15002,"_39":15003,"_67":66},[390,7703],[2551,2920],{},"Read dehydratedState from useLoaderData.",{"_29":15006,"_31":15007},[],{"_33":2680,"_35":15008,"_37":2140,"_39":15009,"_63":15010,"_65":15015,"_67":66},"J9Sb4b4Y",{},[15011],{"_33":2751,"_2788":15012,"_2790":15013,"_39":15014,"_67":66},[1182,6567],[439,6426],{},"Wrap your UI in + .",{"_29":15017,"_31":15018},[],{"_33":2680,"_35":15019,"_37":2140,"_39":15020,"_63":15021,"_65":15026,"_67":66},"ad7Lfb0V",{},[15022],{"_33":2751,"_2788":15023,"_2790":15024,"_39":15025,"_67":66},[1330],[2866],{},"Inside that, use normal useQuery hooks.",{"_29":15028,"_31":15029},[],{"_33":2680,"_35":15030,"_37":2140,"_39":15031,"_63":15032,"_65":15033,"_67":66},"51Hg1532",{},[],"On the server render, React Query uses the prefetched cache.",{"_29":15035,"_31":15036},[],{"_33":2680,"_35":15037,"_37":2140,"_39":15038,"_63":15039,"_65":15045,"_67":66},"RtKZv78a",{},[15040],{"_33":204,"_2788":15041,"_2790":15042,"_39":15043,"_67":15044},[3243],[754],{},"http://data.name","On the first client render, React Query reuses that cache instead of refetching.",{"_33":2680,"_35":15047,"_37":2140,"_39":15048,"_63":15049,"_65":15054,"_67":66},"68b4HfdM",{"_2719":2972},[15050],{"_33":3084,"_2788":15051,"_2790":15052,"_39":15053,"_67":66},[144],[754],{},"In the route component (both server + client)",{"_33":3020,"_35":15056,"_37":2140,"_39":15057,"_63":15058,"_65":15059,"_67":66},"9EOqTSSe",{"_2719":3238},[],"Core idea",{"_29":15061,"_31":15062},[],{"_33":2680,"_35":15063,"_37":2140,"_39":15064,"_63":15065,"_65":15066,"_67":66},"_LESJKqb",{},[],"That’s the pattern.",{"_29":15068,"_31":15069},[],{"_33":3020,"_35":15070,"_37":2140,"_39":15071,"_63":15072,"_65":15073,"_67":66},"kDqnERyC",{},[],"Minimal example in Remix",{"_29":15075,"_31":15076},[],{"_33":3020,"_35":15077,"_37":2140,"_39":15078,"_63":15079,"_65":15080,"_67":66},"f5wgJyQ-",{},[],"1. Root setup",{"_29":15082,"_31":15083},[],{"_33":2680,"_35":15084,"_37":2140,"_39":15085,"_63":15086,"_65":15091,"_67":66},"pup37ide",{},[15087],{"_33":3084,"_2788":15088,"_2790":15089,"_39":15090,"_67":66},[144],[2965],{},"app/root.tsx",{"_29":15093,"_31":15094},[],{"_33":2751,"_35":15095,"_37":2140,"_39":15096,"_63":15097,"_65":15098,"_67":66},"DVQWKW1-",{"_2753":13245},[],"import type { LinksFunction, LoaderFunctionArgs } from \"@remix-run/node\";\nimport { json } from \"@remix-run/node\";\nimport {\n Links,\n Meta,\n Outlet,\n Scripts,\n ScrollRestoration,\n useLoaderData,\n} from \"@remix-run/react\";\nimport {\n QueryClient,\n QueryClientProvider,\n} from \"@tanstack/react-query\";\nimport { Hydrate, dehydrate } from \"@tanstack/react-query\";\nimport { useState } from \"react\";\nimport { getUser } from \"./models/user.server\"; // whatever\n\nexport async function loader(_args: LoaderFunctionArgs) {\n const queryClient = new QueryClient();\n\n // Preload whatever your route tree needs\n await queryClient.prefetchQuery({\n queryKey: [\"user\"],\n queryFn: () => getUser(),\n });\n\n return json({\n dehydratedState: dehydrate(queryClient),\n });\n}\n\nexport default function App() {\n const { dehydratedState } = useLoaderData();\n\n // important: create one client on the client, not on every render\n const [queryClient] = useState(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: { refetchOnWindowFocus: false },\n },\n })\n );\n\n return (\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n );\n}\n",{"_29":15100,"_31":15123},[15101,15112],{"_29":15102,"_31":15103},[],{"_33":2680,"_35":15104,"_37":2140,"_39":15105,"_63":15106,"_65":15111,"_67":66},"cBdFgVzD",{},[15107],{"_33":2751,"_2788":15108,"_2790":15109,"_39":15110,"_67":66},[2087,754],[7703,2817],{},"Loader creates QueryClient, prefetches, then dehydrate.",{"_29":15113,"_31":15114},[],{"_33":2680,"_35":15115,"_37":2140,"_39":15116,"_63":15117,"_65":15122,"_67":66},"T3lkGSR_",{},[15118],{"_33":2751,"_2788":15119,"_2790":15120,"_39":15121,"_67":66},[2817],[6382],{},"Component re-creates a client (client-side stable via useState) and hydrates with loader data.",{"_33":2680,"_35":15124,"_37":2140,"_39":15125,"_63":15126,"_65":15127,"_67":66},"W2H4q0Wx",{"_2719":2972},[],"The key pieces for the pattern are:",{"_29":15129,"_31":15152},[15130,15141],{"_29":15131,"_31":15132},[],{"_33":2680,"_35":15133,"_37":2140,"_39":15134,"_63":15135,"_65":15140,"_67":66},"xPV6eMX-",{},[15136],{"_33":2751,"_2788":15137,"_2790":15138,"_39":15139,"_67":66},[2805],[2889],{},"Return their dehydratedState fragments.",{"_29":15142,"_31":15143},[],{"_33":2680,"_35":15144,"_37":2140,"_39":15145,"_63":15146,"_65":15151,"_67":66},"adZDI3SE",{},[15147],{"_33":2751,"_2788":15148,"_2790":15149,"_39":15150,"_67":66},[3926],[6567],{},"Merge them into a single dehydratedState in root (or have root loader do all prefetching centrally).",{"_33":2680,"_35":15153,"_37":2140,"_39":15154,"_63":15155,"_65":15160,"_67":66},"qbc0zlgC",{"_2719":2972},[15156],{"_33":3084,"_2788":15157,"_2790":15158,"_39":15159,"_67":66},[2805],[6424],{},"You can have more prefetching in child route loaders too, you just need to:",{"_29":15162,"_31":15163},[],{"_33":2680,"_35":15164,"_37":2140,"_39":15165,"_63":15166,"_65":15167,"_67":66},"_xYNawXG",{},[],"But simplest thing that actually works: root loader does the prefetch for the stuff you care about on first paint.",{"_29":15169,"_31":15170},[],{"_33":3020,"_35":15171,"_37":2140,"_39":15172,"_63":15173,"_65":15174,"_67":66},"KSPshdx1",{},[],"2. Normal useQuery in a route",{"_29":15176,"_31":15177},[],{"_33":2680,"_35":15178,"_37":2140,"_39":15179,"_63":15180,"_65":15185,"_67":66},"Gi8euXeD",{},[15181],{"_33":3084,"_2788":15182,"_2790":15183,"_39":15184,"_67":66},[144],[2907],{},"app/routes/_index.tsx",{"_29":15187,"_31":15188},[],{"_33":2751,"_35":15189,"_37":2140,"_39":15190,"_63":15191,"_65":15192,"_67":66},"BFHXiOHU",{"_2753":13245},[],"import { useQuery } from \"@tanstack/react-query\";\nimport { getUser } from \"~/models/user.server\"; // same fn, but don't import server fn in browser in real code; wrap in API call or isomorphic wrapper\n\nasync function fetchUser() {\n // in practice you'd hit an endpoint, not call a server fn directly\n return getUser();\n}\n\nexport default function Index() {\n const { data, isLoading } = useQuery({\n queryKey: [\"user\"],\n queryFn: fetchUser,\n });\n\n if (isLoading) return Loading… ;\n\n return Hi {data.name} ;\n}\n",{"_29":15194,"_31":15195},[],{"_33":2680,"_35":15196,"_37":2140,"_39":15197,"_63":15198,"_65":15203,"_67":66},"_jBer1B9",{},[15199],{"_33":3084,"_2788":15200,"_2790":15201,"_39":15202,"_67":66},[2965],[7703],{},"Because the query key + fn match the prefetched one, the first server render and first client render both pull from the same hydrated cache. Client does the normal React Query lifecycle after that.",{"_29":15205,"_31":15273},[15206,15225,15240],{"_29":15207,"_31":15208},[],{"_33":2680,"_35":15209,"_37":2140,"_39":15210,"_63":15211,"_65":15224,"_67":66},"XmGSKrts",{},[15212,15216,15220],{"_33":3084,"_2788":15213,"_2790":15214,"_39":15215,"_67":66},[144],[649],{},{"_33":2751,"_2788":15217,"_2790":15218,"_39":15219,"_67":66},[2836,6572,9385],[6695,6287,8449],{},{"_33":9788,"_2788":15221,"_2790":15222,"_39":15223,"_67":66},[439],[7518],{},"Do not create a fresh QueryClient on every render of App. You already know this, but that’s why you see the useState(() => new QueryClient()) trick.",{"_29":15226,"_31":15227},[],{"_33":2680,"_35":15228,"_37":2140,"_39":15229,"_63":15230,"_65":15239,"_67":66},"qw0tASn7",{},[15231,15235],{"_33":3084,"_2788":15232,"_2790":15233,"_39":15234,"_67":66},[1835],[1182],{},{"_33":2751,"_2788":15236,"_2790":15237,"_39":15238,"_67":66},[1182,2552],[2907,2793],{},"For streaming / defer, you can’t just blindly use dehydrate once; you’d move some data to Remix’s data streams and possibly stop using React Query for that part.",{"_29":15241,"_31":15264},[15242,15253],{"_29":15243,"_31":15244},[],{"_33":2680,"_35":15245,"_37":2140,"_39":15246,"_63":15247,"_65":15252,"_67":66},"fm8W_87n",{},[15248],{"_33":2751,"_2788":15249,"_2790":15250,"_39":15251,"_67":66},[8172],[6286],{},"centralize prefetch in root loader (route loaders call into it), or",{"_29":15254,"_31":15255},[],{"_33":2680,"_35":15256,"_37":2140,"_39":15257,"_63":15258,"_65":15263,"_67":66},"QJT7Z-BR",{},[15259],{"_33":2751,"_2788":15260,"_2790":15261,"_39":15262,"_67":66},[2866,8079],[3088,6568],{},"have each loader return its own dehydratedState and merge in root (annoying, but doable).",{"_33":2680,"_35":15265,"_37":2140,"_39":15266,"_63":15267,"_65":15272,"_67":66},"QIUVYP1D",{"_2719":2972},[15268],{"_33":3084,"_2788":15269,"_2790":15270,"_39":15271,"_67":66},[2839],[783],{},"If you start doing route-level prefetching, you either:",{"_33":3020,"_35":15274,"_37":2140,"_39":15275,"_63":15276,"_65":15277,"_67":66},"s1uCptpw",{"_2719":2972},[],"Subtle bits you’ll trip on if you’re not careful",{"_29":15279,"_31":15280},[],{"_33":2680,"_35":15281,"_37":2140,"_39":15282,"_63":15283,"_65":15292,"_67":66},"VcdbqCxC",{},[15284,15288],{"_33":3084,"_2788":15285,"_2790":15286,"_39":15287,"_67":66},[6365,8080],[2891,8201],{},{"_33":2751,"_2788":15289,"_2790":15290,"_39":15291,"_67":66},[2891,8201],[8080,2823],{},"But the “pattern” you’re asking for is exactly: loader prefetch → dehydrate → Hydrate + useQuery.",{"_33":3020,"_35":15294,"_37":2140,"_39":15295,"_63":15296,"_65":15297,"_67":66},"IyY14t8Q",{"_2719":243},[],"Specifics - from ChatGPT",[72,75],"/tech-talks/server-rendering-context","2025-12-19T13:25:53.422Z",{"_84":2149,"_86":2150},{},{"_90":2140,"_94":2147},{"_35":2127,"_102":51,"_52":15305,"_68":2130,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2129],1779255260606,[156,2127,2130,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/server-rendering-context\",\"bafy2bzaceaytxh3wlv277trug6jd5g6qwcx2hzsb6w5muy3u54qdps5yrhk4i\",true]",{"_117":15310,"_154":15358,"_157":15359},{"_119":15311,"_139":42,"_140":9172,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":15312,"_35":15356},{"_26":15313,"_68":2156,"_69":51,"_70":15351,"_52":15352,"_78":2163,"_80":2163,"_82":15353,"_88":15354,"_90":2156,"_92":15355,"_96":97},[15314,15329,15336],{"_29":15315,"_31":15316},[],{"_33":2680,"_35":15317,"_37":2156,"_39":15318,"_63":15319,"_65":15328,"_67":66},"QEwbleet",{},[15320,15324],{"_33":3084,"_2788":15321,"_2790":15322,"_39":15323,"_67":66},[144,7520],[6804,7705],{},{"_33":2751,"_2788":15325,"_2790":15326,"_39":15327,"_67":66},[6804],[7520],{},"what's the difference between starting the app from the app icon vs typing seed in the terminal on Linux",{"_29":15330,"_31":15331},[],{"_33":2680,"_35":15332,"_37":2156,"_39":15333,"_63":15334,"_65":15335,"_67":66},"VBBi8X1I",{},[],"I saw different behavior when the app is open from the terminal and I don't understand what is different. or if it should be any difference?",{"_29":15337,"_31":15338},[],{"_33":2680,"_35":15339,"_37":2156,"_39":15340,"_63":15341,"_65":15350,"_67":66},"NlB5Orvh",{},[15342,15346],{"_33":2727,"_2788":15343,"_2790":15344,"_39":15345,"_67":2619},[2965],[2805],{},{"_33":2727,"_2788":15347,"_2790":15348,"_39":15349,"_67":2632},[912],[2087],{},"Do you know ?",[76],"/tech-talks/different-ways-to-open-the-app-in-linux",{"_84":2176,"_86":2177},{},{"_90":2156,"_94":2174},{"_35":2153,"_102":51,"_52":15357,"_68":2156,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2155],[156,2153,2156,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/different-ways-to-open-the-app-in-linux\",\"bafy2bzacedw5bsk5pquz3e7bpp5vlmfkiawcduiipmga62s7bvdiwkh2cmsgo\",true]",{"_117":15361,"_154":15484,"_157":15485},{"_119":15362,"_139":42,"_140":15483,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":15363,"_35":15481},{"_26":15364,"_68":2183,"_69":51,"_70":15476,"_52":15477,"_78":2190,"_80":2190,"_82":15478,"_88":15479,"_90":2183,"_92":15480,"_96":97},[15365,15372],{"_29":15366,"_31":15367},[],{"_33":2680,"_35":15368,"_37":2183,"_39":15369,"_63":15370,"_65":15371,"_67":66},"xkZsOahb",{},[],"In case anybody else has to do this.",{"_29":15373,"_31":15471},[15374,15392,15410,15428,15446,15453],{"_29":15375,"_31":15387},[15376],{"_29":15377,"_31":15378},[],{"_33":2680,"_35":15379,"_37":2183,"_39":15380,"_63":15381,"_65":15386,"_67":66},"jlV65-j_",{},[15382],{"_33":2751,"_2788":15383,"_2790":15384,"_39":15385,"_67":66},[42],[2839],{}," docker stop notify",{"_33":2680,"_35":15388,"_37":2183,"_39":15389,"_63":15390,"_65":15391,"_67":66},"uycKdG1u",{"_2719":243},[],"Stop Email Service",{"_29":15393,"_31":15405},[15394],{"_29":15395,"_31":15396},[],{"_33":2680,"_35":15397,"_37":2183,"_39":15398,"_63":15399,"_65":15404,"_67":66},"vJbBLf3O",{},[15400],{"_33":2751,"_2788":15401,"_2790":15402,"_39":15403,"_67":66},[144],[2822],{},"sudo sqlite3 /shm/gateway/notify/web-db.sqlite",{"_33":2680,"_35":15406,"_37":2183,"_39":15407,"_63":15408,"_65":15409,"_67":66},"AcUZrKRo",{"_2719":243},[],"Open the notifier db",{"_29":15411,"_31":15423},[15412],{"_29":15413,"_31":15414},[],{"_33":2680,"_35":15415,"_37":2183,"_39":15416,"_63":15417,"_65":15422,"_67":66},"VqhSrog0",{},[15418],{"_33":2751,"_2788":15419,"_2790":15420,"_39":15421,"_67":66},[144],[491],{},"select * from notifier_status;",{"_33":2680,"_35":15424,"_37":2183,"_39":15425,"_63":15426,"_65":15427,"_67":66},"TAyWT7kF",{"_2719":243},[],"Read the status table, copy somewhere in case its helpful for later debugging",{"_29":15429,"_31":15441},[15430],{"_29":15431,"_31":15432},[],{"_33":2680,"_35":15433,"_37":2183,"_39":15434,"_63":15435,"_65":15440,"_67":66},"MJjKEh_m",{},[15436],{"_33":2751,"_2788":15437,"_2790":15438,"_39":15439,"_67":66},[144],[2889],{},"delete from notifier_status;",{"_33":2680,"_35":15442,"_37":2183,"_39":15443,"_63":15444,"_65":15445,"_67":66},"fm4_Fr2Z",{"_2719":243},[],"Empty the notifier status table",{"_29":15447,"_31":15448},[],{"_33":2680,"_35":15449,"_37":2183,"_39":15450,"_63":15451,"_65":15452,"_67":66},"O9RmjHvP",{},[],"Close sqlite (ctrl-d)",{"_29":15454,"_31":15466},[15455],{"_29":15456,"_31":15457},[],{"_33":2680,"_35":15458,"_37":2183,"_39":15459,"_63":15460,"_65":15465,"_67":66},"EkCqA-ao",{},[15461],{"_33":2751,"_2788":15462,"_2790":15463,"_39":15464,"_67":66},[144],[2552],{},"docker start notify && docker logs notify -f -n 10",{"_33":2680,"_35":15467,"_37":2183,"_39":15468,"_63":15469,"_65":15470,"_67":66},"69ONOC64",{"_2719":243},[],"Start the notifier service and watch logs",{"_33":2680,"_35":15472,"_37":2183,"_39":15473,"_63":15474,"_65":15475,"_67":66},"VNSUCdew",{"_2719":3238},[],"The workflow is pretty safe. It will reset the batch notification timer, and it should only send new notifications from the time you run this workflow.",[72],"/tech-talks/how-to-reset-email-service",{"_84":2203},{},{"_90":2183,"_94":2201},{"_35":2180,"_102":51,"_52":15482,"_68":2183,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2182],1779255260546,[156,2180,2183,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/how-to-reset-email-service\",\"bafy2bzacec7k2jgfkan4q6yxparh4dfew5xhaenymkrollikrgjvgwhq2vlgs\",true]",{"_117":15487,"_154":15817,"_157":15818},{"_119":15488,"_139":42,"_140":15816,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":15489,"_35":15814},{"_26":15490,"_68":2209,"_69":51,"_70":15809,"_52":15810,"_78":2216,"_80":2216,"_82":15811,"_88":15812,"_90":2209,"_92":15813,"_96":97},[15491,15541,15643],{"_29":15492,"_31":15536},[15493,15522,15529],{"_29":15494,"_31":15517},[15495,15506],{"_29":15496,"_31":15497},[],{"_33":2680,"_35":15498,"_37":2209,"_39":15499,"_63":15500,"_65":15505,"_67":66},"k3jSGXdi",{},[15501],{"_33":2751,"_2788":15502,"_2790":15503,"_39":15504,"_67":66},[144],[912],{},"USER_ID@DOMAIN",{"_29":15507,"_31":15508},[],{"_33":2680,"_35":15509,"_37":2209,"_39":15510,"_63":15511,"_65":15516,"_67":66},"NxCaN5P8",{},[15512],{"_33":2751,"_2788":15513,"_2790":15514,"_39":15515,"_67":66},[2805],[439],{},"For example, K3A8L45@seed.hyper.media",{"_33":2680,"_35":15518,"_37":2209,"_39":15519,"_63":15520,"_65":15521,"_67":66},"7lDyT9G0",{"_2719":243},[],"In addition to the existing account IDs (public keys), we will support a new format with the following shape:",{"_29":15523,"_31":15524},[],{"_33":2680,"_35":15525,"_37":2209,"_39":15526,"_63":15527,"_65":15528,"_67":66},"dw29JnJ4",{},[],"Inside each server, any authentication mechanism can be used to identify and resolve the UserID. For our initial implementation, we will use magic links.",{"_29":15530,"_31":15531},[],{"_33":2680,"_35":15532,"_37":2209,"_39":15533,"_63":15534,"_65":15535,"_67":66},"7knpYzUp",{},[],"These new Validator AccountIDs can be invited to documents, or mentioned. They can even have their own site, but that is not really recommended because they are dependent on another domain.",{"_33":3020,"_35":15537,"_37":2209,"_39":15538,"_63":15539,"_65":15540,"_67":66},"BuWRzJpP",{"_2719":243},[],"New Account ID format",{"_29":15542,"_31":15638},[15543,15550,15571,15592,15606,15620],{"_29":15544,"_31":15545},[],{"_33":2680,"_35":15546,"_37":2209,"_39":15547,"_63":15548,"_65":15549,"_67":66},"bRv1DnVu",{},[],"When you set up a ANY HM host, you must choose at least one of the following options.",{"_29":15551,"_31":15566},[15552,15559],{"_29":15553,"_31":15554},[],{"_33":2680,"_35":15555,"_37":2209,"_39":15556,"_63":15557,"_65":15558,"_67":66},"DAEuYKex",{},[],"In the server, add the SMTP settings (or Mailgun or something). Then the server has the ability to send notification and email settings.",{"_29":15560,"_31":15561},[],{"_33":2680,"_35":15562,"_37":2209,"_39":15563,"_63":15564,"_65":15565,"_67":66},"h8XUHtZU",{},[],"This will enable the \"sign in with email\" workflow. To sign in, the user will type their email address and click \"Verify my Email\"",{"_33":3020,"_35":15567,"_37":2209,"_39":15568,"_63":15569,"_65":15570,"_67":66},"mBF8yd8F",{"_2719":243},[],"Set Up Email Sending",{"_29":15572,"_31":15587},[15573,15580],{"_29":15574,"_31":15575},[],{"_33":2680,"_35":15576,"_37":2209,"_39":15577,"_63":15578,"_65":15579,"_67":66},"eXVRGbrJ",{},[],"The site owner will choose an Upstream Identity Provider where users will authenticate through",{"_29":15581,"_31":15582},[],{"_33":2680,"_35":15583,"_37":2209,"_39":15584,"_63":15585,"_65":15586,"_67":66},"xAIpQ1vl",{},[],"This will enable the \"sign in with \" workflow which feels to the user like OAuth.",{"_33":3020,"_35":15588,"_37":2209,"_39":15589,"_63":15590,"_65":15591,"_67":66},"x4qRxAW9",{"_2719":243},[],"Set Up Allowed Upstream Identity Provider(s)",{"_29":15593,"_31":15601},[15594],{"_29":15595,"_31":15596},[],{"_33":2680,"_35":15597,"_37":2209,"_39":15598,"_63":15599,"_65":15600,"_67":66},"X0fqo7nD",{},[],"Any upstream identity provider will be allowed. So the user can input their own domain. As long as that domain is using the HM protocol, it can provide identity for the current domain.",{"_33":3020,"_35":15602,"_37":2209,"_39":15603,"_63":15604,"_65":15605,"_67":66},"694x_sFr",{"_2719":243},[],"Enabled Any Upstream Identity Provider",{"_29":15607,"_31":15615},[15608],{"_29":15609,"_31":15610},[],{"_33":2680,"_35":15611,"_37":2209,"_39":15612,"_63":15613,"_65":15614,"_67":66},"YlEzOBDb",{},[],"A server may be configured to show the \"device linking\" flow that will allow the identity provider to be based in the desktop app or mobile app. This is the most secure option but it will require more steps from the user. So they should be encouraged to do this.",{"_33":3020,"_35":15616,"_37":2209,"_39":15617,"_63":15618,"_65":15619,"_67":66},"1EQRtjIY",{"_2719":243},[],"App-Based Identity",{"_29":15621,"_31":15633},[15622],{"_29":15623,"_31":15624},[],{"_33":2680,"_35":15625,"_37":2209,"_39":15626,"_63":15627,"_65":15632,"_67":66},"VIBx6whU",{},[15628],{"_33":2751,"_2788":15629,"_2790":15630,"_39":15631,"_67":66},[6366],[6445],{},"If there is no email sending setup, and if there is no upstream identity providers, then we will fall back to using hyper.media as the identity provider.",{"_33":3020,"_35":15634,"_37":2209,"_39":15635,"_63":15636,"_65":15637,"_67":66},"eJl-BIqG",{"_2719":243},[],"Fallback Identity Provider",{"_33":3020,"_35":15639,"_37":2209,"_39":15640,"_63":15641,"_65":15642,"_67":66},"7_c1aA3M",{"_2719":243},[],"Server Config Options",{"_29":15644,"_31":15804},[15645,15687,15707,15763,15777],{"_29":15646,"_31":15682},[15647,15654,15661,15668,15675],{"_29":15648,"_31":15649},[],{"_33":2680,"_35":15650,"_37":2209,"_39":15651,"_63":15652,"_65":15653,"_67":66},"BE0koj7_",{},[],"The user creates a comment on hyper.media and then is prompted to create an account. Or they directly click \"Create Account / Log In\" and the workflow starts.",{"_29":15655,"_31":15656},[],{"_33":2680,"_35":15657,"_37":2209,"_39":15658,"_63":15659,"_65":15660,"_67":66},"_7KOEQLz",{},[],"They get two options: App Identity (secure) or Email Identity (convenient).",{"_29":15662,"_31":15663},[],{"_33":2680,"_35":15664,"_37":2209,"_39":15665,"_63":15666,"_65":15667,"_67":66},"Pry3ufv-",{},[],"The user clicks Email, and they type their email address. When they submit, their browser's public key is sent alongside the email.",{"_29":15669,"_31":15670},[],{"_33":2680,"_35":15671,"_37":2209,"_39":15672,"_63":15673,"_65":15674,"_67":66},"--p8rUHZ",{},[],"The server generates a user ID or looks it up if the email has been used before. A token is generated and emailed to the user. When the email link is clicked, it becomes validated.",{"_29":15676,"_31":15677},[],{"_33":2680,"_35":15678,"_37":2209,"_39":15679,"_63":15680,"_65":15681,"_67":66},"517vZnAS",{},[],"Now when this accountID is mentioned or creates a comment, their name is \"Display Name (hyper.media)\"",{"_33":3020,"_35":15683,"_37":2209,"_39":15684,"_63":15685,"_65":15686,"_67":66},"uEAbN8fE",{"_2719":243},[],"Sign in with hyper.media",{"_29":15688,"_31":15702},[15689,15696],{"_29":15690,"_31":15691},[],{"_33":2680,"_35":15692,"_37":2209,"_39":15693,"_63":15694,"_65":15695,"_67":66},"Q2UszM3T",{},[],"User clicks on \"Sign in with hyper.media\" and there is an OAuth-style redirect to hyper.media where the user may already be signed in, or they can create an account, or they can sign in with the above workflow",{"_29":15697,"_31":15698},[],{"_33":2680,"_35":15699,"_37":2209,"_39":15700,"_63":15701,"_65":15681,"_67":66},"9CACO9bF",{},[],{"_33":3020,"_35":15703,"_37":2209,"_39":15704,"_63":15705,"_65":15706,"_67":66},"gQPNzNJ0",{"_2719":243},[],"Sign in with hyper.media from example.net - H.M is the identity provider",{"_29":15708,"_31":15758},[15709,15716,15751],{"_29":15710,"_31":15711},[],{"_33":2680,"_35":15712,"_37":2209,"_39":15713,"_63":15714,"_65":15715,"_67":66},"uXuGa02L",{},[],"Say we are at example.net (self hosted) and the site owners have disabled all identity provider except for their own email validation. The platform is trying to keep a very streamlined user experience and own all the emails. ",{"_29":15717,"_31":15746},[15718,15725,15732,15739],{"_29":15719,"_31":15720},[],{"_33":2680,"_35":15721,"_37":2209,"_39":15722,"_63":15723,"_65":15724,"_67":66},"-vnY-tsi",{},[],"User ID",{"_29":15726,"_31":15727},[],{"_33":2680,"_35":15728,"_37":2209,"_39":15729,"_63":15730,"_65":15731,"_67":66},"THixrWne",{},[],"Provider ID",{"_29":15733,"_31":15734},[],{"_33":2680,"_35":15735,"_37":2209,"_39":15736,"_63":15737,"_65":15738,"_67":66},"MOE0m9PL",{},[],"Domain (eg example.net)",{"_29":15740,"_31":15741},[],{"_33":2680,"_35":15742,"_37":2209,"_39":15743,"_63":15744,"_65":15745,"_67":66},"tJhLEQ28",{},[],"Signature",{"_33":2680,"_35":15747,"_37":2209,"_39":15748,"_63":15749,"_65":15750,"_67":66},"UNzU5hYL",{"_2719":2972},[],"The user creates a comment or clicks login/register. They see an email input and type their email. When they submit, their browser's public key is sent alongside the email. An email gets sent with a SMTP provider, and the user clicks the email. After confirmation the server signs a validation which contains:",{"_29":15752,"_31":15753},[],{"_33":2680,"_35":15754,"_37":2209,"_39":15755,"_63":15756,"_65":15757,"_67":66},"-z1nhXsi",{},[],"This validation will be distributed alongside the content to make sure that people know who this person is.",{"_33":3020,"_35":15759,"_37":2209,"_39":15760,"_63":15761,"_65":15762,"_67":66},"DYZuLbX7",{"_2719":243},[],"Sign in with email address - example.net is the identity provider",{"_29":15764,"_31":15772},[15765],{"_29":15766,"_31":15767},[],{"_33":2680,"_35":15768,"_37":2209,"_39":15769,"_63":15770,"_65":15771,"_67":66},"1s7W6Aq1",{},[],"Similar workflow to \"sign in with hyper.media\" but the user is allowed to type any domain. They will be redirected to this domain for auth.",{"_33":3020,"_35":15773,"_37":2209,"_39":15774,"_63":15775,"_65":15776,"_67":66},"HzdM4ja9",{"_2719":243},[],"Sign in with , user input domain",{"_29":15778,"_31":15799},[15779,15786,15793],{"_29":15780,"_31":15781},[],{"_33":2680,"_35":15782,"_37":2209,"_39":15783,"_63":15784,"_65":15785,"_67":66},"u9lNW-RA",{},[],"Similar to the device linking workflow we have today, ideally with an improved UX and with mobile app support",{"_29":15787,"_31":15788},[],{"_33":2680,"_35":15789,"_37":2209,"_39":15790,"_63":15791,"_65":15792,"_67":66},"RE2m5xjr",{},[],"Their account ID will just be the normal key-based account ID of the app identity. When this account is mentioned or when they make a comment, their self-proclaimed name will be shown without any domain name.",{"_29":15794,"_31":15795},[],{"_33":2680,"_35":15796,"_37":2209,"_39":15797,"_63":15798,"_65":66,"_67":66},"lBC9htkH",{},[],{"_33":3020,"_35":15800,"_37":2209,"_39":15801,"_63":15802,"_65":15803,"_67":66},"rJ7UreoQ",{"_2719":243},[],"Sign in with Seed App",{"_33":3020,"_35":15805,"_37":2209,"_39":15806,"_63":15807,"_65":15808,"_67":66},"3ITDMWg7",{"_2719":243},[],"User Auth Workflow Options",[72],"/tech-talks/notes-on-validation-auth-providers",{"_84":2229},{},{"_90":2209,"_94":2227},{"_35":2206,"_102":51,"_52":15815,"_68":2209,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2208],1779255260608,[156,2206,2209,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/notes-on-validation-auth-providers\",\"bafy2bzaceduqbgedwemclumwdpedxmg3yblgywqhrfnip3fcepfjpqzlhdc6y\",true]",{"_117":15820,"_154":15990,"_157":15991},{"_119":15821,"_139":42,"_140":15989,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":15822,"_35":15987},{"_26":15823,"_68":2235,"_69":51,"_70":15982,"_52":15983,"_78":2242,"_80":2242,"_82":15984,"_88":15985,"_90":2235,"_92":15986,"_96":97},[15824,15835,15872,15932],{"_29":15825,"_31":15826},[],{"_33":2680,"_35":15827,"_37":2235,"_39":15828,"_63":15829,"_65":15834,"_67":66},"1hGYYIsT",{},[15830],{"_33":3084,"_2788":15831,"_2790":15832,"_39":15833,"_67":66},[2966,6572,10108],[2890,6612,6426],{},"Seed Hypermedia’s p2p sync is built around identity, trust, and relevance. Because of that, it is fundamentally different from gossip protocols, even if both operate in distributed, peer-to-peer environments.",{"_29":15836,"_31":15867},[15837,15849,15860],{"_29":15838,"_31":15839},[],{"_33":2680,"_35":15840,"_37":2235,"_39":15841,"_63":15842,"_65":15848,"_67":66},"ked_xdUD",{},[15843],{"_33":9788,"_2788":15844,"_2790":15845,"_39":15847,"_67":66},[9757],[15846],160,{},"Gossip protocols disseminate messages across a broad or semi-broad set of peers using mesh fanout and probabilistic forwarding. They don’t know who specifically should receive the message- only that it should spread. This just allows spam to spread.",{"_29":15850,"_31":15851},[],{"_33":2680,"_35":15852,"_37":2235,"_39":15853,"_63":15854,"_65":15859,"_67":66},"uWUBi1_y",{},[15855],{"_33":3084,"_2788":15856,"_2790":15857,"_39":15858,"_67":66},[6695],[7724],{},"Seed sync has the opposite goal: replicate resources only to peers with explicit trust or relevance relationships.",{"_29":15861,"_31":15862},[],{"_33":2680,"_35":15863,"_37":2235,"_39":15864,"_63":15865,"_65":15866,"_67":66},"PLRJvRfR",{},[],"No broadcast. No fanout.",{"_33":3020,"_35":15868,"_37":2235,"_39":15869,"_63":15870,"_65":15871,"_67":66},"HT6PQnNL",{"_2719":243},[],"1. Gossip spreads widely; Seed sync is narrowly scoped",{"_29":15873,"_31":15927},[15874,15909,15920],{"_29":15875,"_31":15904},[15876,15883,15897],{"_29":15877,"_31":15878},[],{"_33":2680,"_35":15879,"_37":2235,"_39":15880,"_63":15881,"_65":15882,"_67":66},"8E06HnxB",{},[],"verified ownership of sites",{"_29":15884,"_31":15892},[15885],{"_29":15886,"_31":15887},[],{"_33":2680,"_35":15888,"_37":2235,"_39":15889,"_63":15890,"_65":15891,"_67":66},"as3ol4i1",{},[],"including identity delegation, or",{"_33":2680,"_35":15893,"_37":2235,"_39":15894,"_63":15895,"_65":15896,"_67":66},"thuVS0Dp",{"_2719":2972},[],"trusted contacts (and therefore peers),",{"_29":15898,"_31":15899},[],{"_33":2680,"_35":15900,"_37":2235,"_39":15901,"_63":15902,"_65":15903,"_67":66},"czbk7Qs_",{},[],"explicit subscriptions.",{"_33":2680,"_35":15905,"_37":2235,"_39":15906,"_63":15907,"_65":15908,"_67":66},"G3wjD5CY",{"_2719":2972},[],"Eligible recipients are known in advance via:",{"_29":15910,"_31":15911},[],{"_33":2680,"_35":15912,"_37":2235,"_39":15913,"_63":15914,"_65":15919,"_67":66},"OFtGor1Q",{},[15915],{"_33":3084,"_2788":15916,"_2790":15917,"_39":15918,"_67":66},[1057,2918,2806],[1182,3926,2822],{},"This is directed, bounded, and user-controlled, not emergent or random.",{"_29":15921,"_31":15922},[],{"_33":2680,"_35":15923,"_37":2235,"_39":15924,"_63":15925,"_65":15926,"_67":66},"7oF-l-95",{},[],"We should never push content to uninterested or random peers.",{"_33":3020,"_35":15928,"_37":2235,"_39":15929,"_63":15930,"_65":15931,"_67":66},"_dMtH5uo",{"_2719":243},[],"2. Seed’s propagation graph is identity-defined",{"_29":15933,"_31":15973},[15934,15962],{"_29":15935,"_31":15957},[15936,15943,15950],{"_29":15937,"_31":15938},[],{"_33":2680,"_35":15939,"_37":2235,"_39":15940,"_63":15941,"_65":15942,"_67":66},"ICXNJzNA",{},[],"mesh spreading,",{"_29":15944,"_31":15945},[],{"_33":2680,"_35":15946,"_37":2235,"_39":15947,"_63":15948,"_65":15949,"_67":66},"__U1W-s9",{},[],"redundant forwarding of blobs, or,",{"_29":15951,"_31":15952},[],{"_33":2680,"_35":15953,"_37":2235,"_39":15954,"_63":15955,"_65":15956,"_67":66},"kMGHqngb",{},[],"probabilistic delivery across the network.",{"_33":2680,"_35":15958,"_37":2235,"_39":15959,"_63":15960,"_65":15961,"_67":66},"Ux5m2H_n",{"_2719":2972},[],"Gossip relies on repeated spreading until high-probability coverage is reached. Seed does not perform:",{"_29":15963,"_31":15964},[],{"_33":2680,"_35":15965,"_37":2235,"_39":15966,"_63":15967,"_65":15972,"_67":66},"-tWwgXQS",{},[15968],{"_33":3084,"_2788":15969,"_2790":15970,"_39":15971,"_67":66},[2907],[6837],{},"Our sync should have targeted delivery, not epidemic dissemination.",{"_33":3020,"_35":15974,"_37":2235,"_39":15975,"_63":15976,"_65":15981,"_67":66},"asf0lBvZ",{"_2719":243},[15977],{"_33":3084,"_2788":15978,"_2790":15979,"_39":15980,"_67":66},[144],[8222],{},"3. Seed does not use epidemic convergence",[72],"/tech-talks/our-syncing-model-should-not-be-a-gossip-protocol",{"_84":2255},{},{"_90":2235,"_94":2253},{"_35":2232,"_102":51,"_52":15988,"_68":2235,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2234],1779255260577,[156,2232,2235,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/our-syncing-model-should-not-be-a-gossip-protocol\",\"bafy2bzacecyh35dx2p2gwienoymmqeixeawthgcayzv4deji63goukkql54wo\",true]",{"_117":15993,"_154":16276,"_157":16277},{"_119":15994,"_139":42,"_140":7187,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":15995,"_35":16274},{"_26":15996,"_68":2261,"_69":51,"_70":16269,"_52":16270,"_78":2267,"_80":2267,"_82":16271,"_88":16272,"_90":2261,"_92":16273,"_96":97},[15997],{"_29":15998,"_31":16264},[15999,16141,16148,16162],{"_29":16000,"_31":16136},[16001],{"_29":16002,"_31":16131},[16003,16118],{"_29":16004,"_31":16113},[16005],{"_29":16006,"_31":16104},[16007,16074],{"_29":16008,"_31":16065},[16009,16016,16037,16051,16058],{"_29":16010,"_31":16011},[],{"_33":2680,"_35":16012,"_37":2261,"_39":16013,"_63":16014,"_65":16015,"_67":66},"k9kMnX7N",{},[],"latestVersion: [cid1.cid2]",{"_29":16017,"_31":16032},[16018,16025],{"_29":16019,"_31":16020},[],{"_33":2680,"_35":16021,"_37":2261,"_39":16022,"_63":16023,"_65":16024,"_67":66},"QUzLTAHo",{},[],"resource: [AccountID+Path]",{"_29":16026,"_31":16027},[],{"_33":2680,"_35":16028,"_37":2261,"_39":16029,"_63":16030,"_65":16031,"_67":66},"0ivNFf9j",{},[],"mention metadata?",{"_33":2680,"_35":16033,"_37":2261,"_39":16034,"_63":16035,"_65":16036,"_67":66},"k_5eGN-A",{"_2719":2972},[],"mentions array:",{"_29":16038,"_31":16046},[16039],{"_29":16040,"_31":16041},[],{"_33":2680,"_35":16042,"_37":2261,"_39":16043,"_63":16044,"_65":16045,"_67":66},"FTwY0DG6",{},[],"[Resource: AccountID+Path]",{"_33":2680,"_35":16047,"_37":2261,"_39":16048,"_63":16049,"_65":16050,"_67":66},"DoUUCqZF",{"_2719":2972},[],"comments array:",{"_29":16052,"_31":16053},[],{"_33":2680,"_35":16054,"_37":2261,"_39":16055,"_63":16056,"_65":16057,"_67":66},"k6PuOvTE",{},[],"activity: TBD - cache the activity events about this specific resource",{"_29":16059,"_31":16060},[],{"_33":2680,"_35":16061,"_37":2261,"_39":16062,"_63":16063,"_65":16064,"_67":66},"NJLIN6qm",{},[],"search: TBD - cache search results when your search is narrowed to this resource",{"_33":2680,"_35":16066,"_37":2261,"_39":16067,"_63":16068,"_65":16073,"_67":66},"K5BOsXu6",{"_2719":2972},[16069],{"_33":2751,"_2788":16070,"_2790":16071,"_39":16072,"_67":66},[390],[2839],{},"when type: Document",{"_29":16075,"_31":16095},[16076,16083],{"_29":16077,"_31":16078},[],{"_33":2680,"_35":16079,"_37":2261,"_39":16080,"_63":16081,"_65":16082,"_67":66},"Z375PsLT",{},[],"latestVersion: [cid]",{"_29":16084,"_31":16091},[16085],{"_29":16086,"_31":16087},[],{"_33":2680,"_35":16088,"_37":2261,"_39":16089,"_63":16090,"_65":16024,"_67":66},"ft4OLTgV",{},[],{"_33":2680,"_35":16092,"_37":2261,"_39":16093,"_63":16094,"_65":16036,"_67":66},"-KTDM5lH",{"_2719":2972},[],{"_33":2680,"_35":16096,"_37":2261,"_39":16097,"_63":16098,"_65":16103,"_67":66},"0L6HMmHj",{"_2719":2972},[16099],{"_33":2751,"_2788":16100,"_2790":16101,"_39":16102,"_67":66},[390],[2918],{},"when type: Comment",{"_33":2680,"_35":16105,"_37":2261,"_39":16106,"_63":16107,"_65":16112,"_67":66},"Q0J-mkkC",{"_2719":2972},[16108],{"_33":2751,"_2788":16109,"_2790":16110,"_39":16111,"_67":66},[439,6612],[2878,6426],{},"[Path] - empty string for home docs, /[TSID] for CCC, and /human/readable for children docs",{"_33":2680,"_35":16114,"_37":2261,"_39":16115,"_63":16116,"_65":16117,"_67":66},"0YX6RaxJ",{"_2719":2972},[],"Paths",{"_29":16119,"_31":16127},[16120],{"_29":16121,"_31":16122},[],{"_33":2680,"_35":16123,"_37":2261,"_39":16124,"_63":16125,"_65":16126,"_67":66},"MmRH7Wgv",{},[],"latestCid: [cid]",{"_33":2680,"_35":16128,"_37":2261,"_39":16129,"_63":16130,"_65":7238,"_67":66},"c0MRUt7l",{"_2719":2972},[],{"_33":2680,"_35":16132,"_37":2261,"_39":16133,"_63":16134,"_65":16135,"_67":66},"mYQqAN76",{"_2719":2972},[],"[Account_ID]",{"_33":2680,"_35":16137,"_37":2261,"_39":16138,"_63":16139,"_65":16140,"_67":66},"P9kUtE8T",{"_2719":2972},[],"Account",{"_29":16142,"_31":16143},[],{"_33":2680,"_35":16144,"_37":2261,"_39":16145,"_63":16146,"_65":16147,"_67":66},"un5elriM",{},[],"search - used to cache search results when searching the whole node",{"_29":16149,"_31":16157},[16150],{"_29":16151,"_31":16152},[],{"_33":2680,"_35":16153,"_37":2261,"_39":16154,"_63":16155,"_65":16156,"_67":66},"03ioYvMj",{},[],"will reference the Path Resources: [AccountID+Path] or the Profile: [AccountID]",{"_33":2680,"_35":16158,"_37":2261,"_39":16159,"_63":16160,"_65":16161,"_67":66},"aJM2Yp05",{"_2719":2972},[],"activity - cache the node's global activity events",{"_29":16163,"_31":16259},[16164,16226],{"_29":16165,"_31":16221},[16166,16200],{"_29":16167,"_31":16195},[16168,16188],{"_29":16169,"_31":16183},[16170,16177],{"_29":16171,"_31":16172},[],{"_33":2680,"_35":16173,"_37":2261,"_39":16174,"_63":16175,"_65":16176,"_67":66},"fVXwPqfh",{},[],"Metadata",{"_29":16178,"_31":16179},[],{"_33":2680,"_35":16180,"_37":2261,"_39":16181,"_63":16182,"_65":9340,"_67":66},"7lC8HTkX",{},[],{"_33":2680,"_35":16184,"_37":2261,"_39":16185,"_63":16186,"_65":16187,"_67":66},"rYdfc83i",{"_2719":2972},[],"State - the current state",{"_29":16189,"_31":16190},[],{"_33":2680,"_35":16191,"_37":2261,"_39":16192,"_63":16193,"_65":16194,"_67":66},"5pi1OrxG",{},[],"Blob Data (as it saved in IPFS)",{"_33":2680,"_35":16196,"_37":2261,"_39":16197,"_63":16198,"_65":16199,"_67":66},"gLWkB8w3",{"_2719":2972},[],"when a document change:",{"_29":16201,"_31":16216},[16202,16209],{"_29":16203,"_31":16204},[],{"_33":2680,"_35":16205,"_37":2261,"_39":16206,"_63":16207,"_65":16208,"_67":66},"io1m56fJ",{},[],"Blob Data (as it is saved in IPFS)",{"_29":16210,"_31":16211},[],{"_33":2680,"_35":16212,"_37":2261,"_39":16213,"_63":16214,"_65":16215,"_67":66},"9l7BoUuR",{},[],"Metadata? If only used if the full blob data is not loaded",{"_33":2680,"_35":16217,"_37":2261,"_39":16218,"_63":16219,"_65":16220,"_67":66},"O4pp5l6Z",{"_2719":2972},[],"when a comment, cap, contact, profile:",{"_33":2680,"_35":16222,"_37":2261,"_39":16223,"_63":16224,"_65":16225,"_67":66},"qr32bZWk",{"_2719":2972},[],"[CID]",{"_29":16227,"_31":16254},[16228,16235],{"_29":16229,"_31":16230},[],{"_33":2680,"_35":16231,"_37":2261,"_39":16232,"_63":16233,"_65":16234,"_67":66},"Ta5nr5sx",{},[],"for document versions only",{"_29":16236,"_31":16249},[16237,16243],{"_29":16238,"_31":16239},[],{"_33":2680,"_35":16240,"_37":2261,"_39":16241,"_63":16242,"_65":16176,"_67":66},"YVeXFKhT",{},[],{"_29":16244,"_31":16245},[],{"_33":2680,"_35":16246,"_37":2261,"_39":16247,"_63":16248,"_65":9340,"_67":66},"cLV-Hsm6",{},[],{"_33":2680,"_35":16250,"_37":2261,"_39":16251,"_63":16252,"_65":16253,"_67":66},"Yl65tRYq",{"_2719":2972},[],"State - if this is a document version",{"_33":2680,"_35":16255,"_37":2261,"_39":16256,"_63":16257,"_65":16258,"_67":66},"qr9nQzJ0",{"_2719":2972},[],"[CID1.CID2]",{"_33":2680,"_35":16260,"_37":2261,"_39":16261,"_63":16262,"_65":16263,"_67":66},"cHR9eIUP",{"_2719":2972},[],"Immutable",{"_33":2680,"_35":16265,"_37":2261,"_39":16266,"_63":16267,"_65":16268,"_67":66},"Uf_VvD3_",{"_2719":2972},[],"On the frontend team we are designing the new normalized data structure, which is how the client will organize all data that is received from the API",[72],"/tech-talks/normalized-data-shape",{"_84":2276},{},{"_90":2261,"_94":2274},{"_35":2258,"_102":51,"_52":16275,"_68":2261,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2260],[156,2258,2261,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/normalized-data-shape\",\"bafy2bzacebhphgzlfsmzgwx4xveuxmu6nmdmuwixvz4sfq6gmtiercq4t43js\",true]",{"_117":16279,"_154":16509,"_157":16510},{"_119":16280,"_139":42,"_140":16508,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":16281,"_35":16506},{"_26":16282,"_68":2307,"_69":51,"_70":16501,"_52":16502,"_78":2313,"_80":2313,"_82":16503,"_88":16504,"_90":2307,"_92":16505,"_96":97},[16283,16290,16370,16473],{"_29":16284,"_31":16285},[],{"_33":2680,"_35":16286,"_37":2307,"_39":16287,"_63":16288,"_65":16289,"_67":66},"KToeRvO_",{},[],"We have been making progress towards reducing redundant code when querying data from web and desktop. This proposal takes another big step in that direction.",{"_29":16291,"_31":16365},[16292,16299,16331,16344,16351,16358],{"_29":16293,"_31":16294},[],{"_33":2680,"_35":16295,"_37":2307,"_39":16296,"_63":16297,"_65":16298,"_67":66},"qL-jOEon",{},[],"When introducing a new feature that loads data from the daemon, we have to write a lot of code to implement it on web and desktop.",{"_29":16300,"_31":16322},[16301,16308,16315],{"_29":16302,"_31":16303},[],{"_33":2680,"_35":16304,"_37":2307,"_39":16305,"_63":16306,"_65":16307,"_67":66},"7kcvHJKo",{},[],"is harder to maintain",{"_29":16309,"_31":16310},[],{"_33":2680,"_35":16311,"_37":2307,"_39":16312,"_63":16313,"_65":16314,"_67":66},"EFW1PkO_",{},[],"may cause different behavior between platforms",{"_29":16316,"_31":16317},[],{"_33":2680,"_35":16318,"_37":2307,"_39":16319,"_63":16320,"_65":16321,"_67":66},"Z9QT18EG",{},[],"might force us to solve the same bug twice",{"_33":2680,"_35":16323,"_37":2307,"_39":16324,"_63":16325,"_65":16330,"_67":66},"GFJ9512r",{"_2719":2972},[16326],{"_33":2751,"_2788":16327,"_2790":16328,"_39":16329,"_67":66},[7520],[6574],{},"Some of our existing endpoints do not properly share code. For example see how grpcClient.entities.searchEntities is called with different code on web and desktop, which:",{"_29":16332,"_31":16333},[],{"_33":2680,"_35":16334,"_37":2307,"_39":16335,"_63":16336,"_65":16343,"_67":66},"VdPSGVDw",{},[16337],{"_33":2751,"_2788":16338,"_2790":16340,"_39":16342,"_67":66},[6400,7712,16339],218,[6547,16341,6404],137,{},"The easiest way to understand this issue is by looking at the implementations of desktop-universal-client and create-web-universal-client. Note how some of these code paths share the underlying implementation, such as fetchDirectory, but most of them do not.",{"_29":16345,"_31":16346},[],{"_33":2680,"_35":16347,"_37":2307,"_39":16348,"_63":16349,"_65":16350,"_67":66},"IUnDHh3T",{},[],"An API router would act as a uniform solution to these two problems, reducing boilerplate and enforcing shared code patterns.",{"_29":16352,"_31":16353},[],{"_33":2680,"_35":16354,"_37":2307,"_39":16355,"_63":16356,"_65":16357,"_67":66},"-X08Ufdn",{},[],"This new pattern will make it more difficult to have fragmented code with different behavior and different bugs. So it will encourage us to have better code.",{"_29":16359,"_31":16360},[],{"_33":2680,"_35":16361,"_37":2307,"_39":16362,"_63":16363,"_65":16364,"_67":66},"A7HwITjY",{},[],"In our current \"universal client\" we also have a mix of fetchers and hooks. We should move to the fetcher pattern which will be enable a more lightweight \"universal client\", and will be more consistent than having a mix of patterns.",{"_33":3020,"_35":16366,"_37":2307,"_39":16367,"_63":16368,"_65":16369,"_67":66},"kYakHXBk",{"_2719":243},[],"Our Current Situation",{"_29":16371,"_31":16468},[16372,16414,16421,16428,16435,16447],{"_29":16373,"_31":16409},[16374,16381,16388,16395,16402],{"_29":16375,"_31":16376},[],{"_33":2680,"_35":16377,"_37":2307,"_39":16378,"_63":16379,"_65":16380,"_67":66},"ioypqSJp",{},[],"a key/name to identify it",{"_29":16382,"_31":16383},[],{"_33":2680,"_35":16384,"_37":2307,"_39":16385,"_63":16386,"_65":16387,"_67":66},"aGwRfzfi",{},[],"zod(ts) types for input and output",{"_29":16389,"_31":16390},[],{"_33":2680,"_35":16391,"_37":2307,"_39":16392,"_63":16393,"_65":16394,"_67":66},"m8tQllYp",{},[],"an implementation that takes a strongly typed input and returns a strongly-typed HMType, using the GRPC client",{"_29":16396,"_31":16397},[],{"_33":2680,"_35":16398,"_37":2307,"_39":16399,"_63":16400,"_65":16401,"_67":66},"ft_x-c10",{},[],"optional: provide details for serializing+deserializing the input to a URL",{"_29":16403,"_31":16404},[],{"_33":2680,"_35":16405,"_37":2307,"_39":16406,"_63":16407,"_65":16408,"_67":66},"PFjCqUTg",{},[],"future: optionally defines caching metadata for HTTP cache and intelligent client caching",{"_33":2680,"_35":16410,"_37":2307,"_39":16411,"_63":16412,"_65":16413,"_67":66},"FJTtc9yD",{"_2719":2972},[],"We will introduce a new API router which allows us to specify endpoints for querying data. Each endpoint has:",{"_29":16415,"_31":16416},[],{"_33":2680,"_35":16417,"_37":2307,"_39":16418,"_63":16419,"_65":16420,"_67":66},"K5J5G1nH",{},[],"We can convert each endpoint, one at a time. Eventually the \"desktop-universal-client\" and \"create-web-universal-client\" files will loose all of the specific fetchers and hooks. So you won't need to touch these files when introducing or modifying the data endpoints.",{"_29":16422,"_31":16423},[],{"_33":2680,"_35":16424,"_37":2307,"_39":16425,"_63":16426,"_65":16427,"_67":66},"V4Id-lW8",{},[],"This solution will use zod validation always, instead of type coercion, to ensure that the frontend code always receives valid data according to the schemas. Even when we have API drift (which should happen rarely, anyways), the frontend will have predictable errors.",{"_29":16429,"_31":16430},[],{"_33":2680,"_35":16431,"_37":2307,"_39":16432,"_63":16433,"_65":16434,"_67":66},"IRwD9CAf",{},[],"In addition, the client model hooks should be shared between platforms, so you will only have to implement one when creating a new endpoint.",{"_29":16436,"_31":16437},[],{"_33":2680,"_35":16438,"_37":2307,"_39":16439,"_63":16440,"_65":16446,"_67":66},"Od7Kiui0",{},[16441],{"_33":204,"_2788":16442,"_2790":16443,"_39":16444,"_67":16445},[439],[8080],{},"https://github.com/seed-hypermedia/seed/pull/127","Take a look a the pull request here: https://github.com/seed-hypermedia/seed/pull/127",{"_29":16448,"_31":16463},[16449,16456],{"_29":16450,"_31":16451},[],{"_33":2680,"_35":16452,"_37":2307,"_39":16453,"_63":16454,"_65":16455,"_67":66},"Vq-TmmUa",{},[],"For now we will continue using React Query",{"_29":16457,"_31":16458},[],{"_33":2680,"_35":16459,"_37":2307,"_39":16460,"_63":16461,"_65":16462,"_67":66},"Z4AAhi26",{},[],"For now we will continue with the pattern where the desktop frontend calls gRPC directly. Eventually we may decide to run the API router on the middle end, exposing the same http interface to the desktop windows as we use on web. Until we have a more sophisticated invalidation system, there is little benefit in this change (and may result in a little extra overhead because of the extra server).",{"_33":3020,"_35":16464,"_37":2307,"_39":16465,"_63":16466,"_65":16467,"_67":66},"8NtZizPg",{"_2719":243},[],"No Goes",{"_33":3020,"_35":16469,"_37":2307,"_39":16470,"_63":16471,"_65":16472,"_67":66},"10EEayjj",{"_2719":243},[],"An Incremental Solution",{"_29":16474,"_31":16496},[16475,16482,16489],{"_29":16476,"_31":16477},[],{"_33":2680,"_35":16478,"_37":2307,"_39":16479,"_63":16480,"_65":16481,"_67":66},"31jZQXE5",{},[],"This is an incremental step that will be far easier to implement in our current codebase.",{"_29":16483,"_31":16484},[],{"_33":2680,"_35":16485,"_37":2307,"_39":16486,"_63":16487,"_65":16488,"_67":66},"03rEFbVw",{},[],"Vanilla GraphQL does not support caching very well using HTTP primitives, and we want to make sure.",{"_29":16490,"_31":16491},[],{"_33":2680,"_35":16492,"_37":2307,"_39":16493,"_63":16494,"_65":16495,"_67":66},"zYeEt3iS",{},[],"If we do decide to adopt GraphQL in the future, it will be easier to transition from this uniform pattern than the mess that we have today.",{"_33":3020,"_35":16497,"_37":2307,"_39":16498,"_63":16499,"_65":16500,"_67":66},"Q82qF0Wb",{"_2719":243},[],"Why this approach is better than GraphQL",[72],"/tech-talks/query-router-proposal",{"_84":2326,"_86":2327},{},{"_90":2307,"_94":2324},{"_35":2304,"_102":51,"_52":16507,"_68":2307,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2306],1779255260576,[156,2304,2307,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/query-router-proposal\",\"bafy2bzacect5jcnf6qbxsqmtdgqghr5cikvfhogx3jfzvpbvw2e7lyy3bwntg\",true]",{"_117":16512,"_154":16990,"_157":16991},{"_119":16513,"_139":42,"_140":16989,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":16514,"_35":16987},{"_26":16515,"_68":2333,"_69":51,"_70":16982,"_52":16983,"_78":2340,"_80":2340,"_82":16984,"_88":16985,"_90":2333,"_92":16986,"_96":97},[16516,16728],{"_29":16517,"_31":16724},[16518,16595,16602,16609,16677],{"_29":16519,"_31":16586},[16520,16531,16542,16553,16564,16575],{"_29":16521,"_31":16522},[],{"_33":2680,"_35":16523,"_37":2333,"_39":16524,"_63":16525,"_65":16530,"_67":66},"Nd76QfcL",{},[16526],{"_33":2751,"_2788":16527,"_2790":16528,"_39":16529,"_67":66},[144,6695],[491,6572],{},"@shm/shared/resource-loader.ts → createResourceLoader — throws on error, no extra work",{"_29":16532,"_31":16533},[],{"_33":2680,"_35":16534,"_37":2333,"_39":16535,"_63":16536,"_65":16541,"_67":66},"8ij4oY3j",{},[16537],{"_33":2751,"_2788":16538,"_2790":16539,"_39":16540,"_67":66},[144,2907,2966],[2918,2866,6424],{},"web/loaders.ts:370 → getResource — returns not-found, no extra work",{"_29":16543,"_31":16544},[],{"_33":2680,"_35":16545,"_37":2333,"_39":16546,"_63":16547,"_65":16552,"_67":66},"JnfCJUzW",{},[16548],{"_33":2751,"_2788":16549,"_2790":16550,"_39":16551,"_67":66},[144,2907],[2918,6695],{},"web/loaders.ts:407 → loadResource — throws on error, adds author metadata etc (see below)",{"_29":16554,"_31":16555},[],{"_33":2680,"_35":16556,"_37":2333,"_39":16557,"_63":16558,"_65":16563,"_67":66},"QOHHpR8R",{},[16559],{"_33":2751,"_2788":16560,"_2790":16561,"_39":16562,"_67":66},[144,2551,783],[2821,2806,2890],{},"notify/loaders.ts → getResource — returns not-found, no extra work",{"_29":16565,"_31":16566},[],{"_33":2680,"_35":16567,"_37":2333,"_39":16568,"_63":16569,"_65":16574,"_67":66},"RELZmeX2",{},[16570],{"_33":2751,"_2788":16571,"_2790":16572,"_39":16573,"_67":66},[144,2551],[2821,2866],{},"notify/loaders.ts → loadResource — throws on error, same as web",{"_29":16576,"_31":16577},[],{"_33":2680,"_35":16578,"_37":2333,"_39":16579,"_63":16580,"_65":16585,"_67":66},"MMFiay5P",{},[16581],{"_33":2751,"_2788":16582,"_2790":16583,"_39":16584,"_67":66},[144,7703,7518],[8172,6837,6612],{},"desktop/entities.ts:154 → loadResource — returns not-found, no extra work",{"_33":2680,"_35":16587,"_37":2333,"_39":16588,"_63":16589,"_65":16594,"_67":66},"myUV0kFQ",{"_2719":2972},[16590],{"_33":2751,"_2788":16591,"_2790":16592,"_39":16593,"_67":66},[3243],[6289],{},"Six places make the same GRPC call (grpcClient.resources.getResource):",{"_29":16596,"_31":16597},[],{"_33":2680,"_35":16598,"_37":2333,"_39":16599,"_63":16600,"_65":16601,"_67":66},"1ypN8M5k",{},[],"This means that we have duplicate or conflicting logic about processing the GRPC data, across many different locations in the code.",{"_29":16603,"_31":16604},[],{"_33":2680,"_35":16605,"_37":2333,"_39":16606,"_63":16607,"_65":16608,"_67":66},"-m_akihR",{},[],"It is not clear what is the responsibility of a \"loader\". Does it fetch for related data like authors? Does it handle redirects or not?",{"_29":16610,"_31":16668},[16611,16622,16629,16636,16643,16650,16657],{"_29":16612,"_31":16613},[],{"_33":2680,"_35":16614,"_37":2333,"_39":16615,"_63":16616,"_65":16621,"_67":66},"P7NHjv7r",{},[16617],{"_33":2751,"_2788":16618,"_2790":16619,"_39":16620,"_67":66},[2920],[2853],{},"Author metadata (name, avatar for each document.authors)",{"_29":16623,"_31":16624},[],{"_33":2680,"_35":16625,"_37":2333,"_39":16626,"_63":16627,"_65":16628,"_67":66},"ts1nY4KO",{},[],"Breadcrumb navigation (metadata for each parent path)",{"_29":16630,"_31":16631},[],{"_33":2680,"_35":16632,"_37":2333,"_39":16633,"_63":16634,"_65":16635,"_67":66},"Z7TA5kBh",{},[],"Support documents (docs referenced via embeds/links in content)",{"_29":16637,"_31":16638},[],{"_33":2680,"_35":16639,"_37":2333,"_39":16640,"_63":16641,"_65":16642,"_67":66},"0i66W1RV",{},[],"Support queries (results from query blocks in content)",{"_29":16644,"_31":16645},[],{"_33":2680,"_35":16646,"_37":2333,"_39":16647,"_63":16648,"_65":16649,"_67":66},"kcCjb_77",{},[],"Directory results (children of home doc and current doc)",{"_29":16651,"_31":16652},[],{"_33":2680,"_35":16653,"_37":2333,"_39":16654,"_63":16655,"_65":16656,"_67":66},"La_DYmm0",{},[],"Home document (for site navigation header)",{"_29":16658,"_31":16659},[],{"_33":2680,"_35":16660,"_37":2333,"_39":16661,"_63":16662,"_65":16667,"_67":66},"KoJ03rxm",{},[16663],{"_33":2751,"_2788":16664,"_2790":16665,"_39":16666,"_67":66},[144],[1057],{},"isLatest flag (compares current version to latest)",{"_33":3020,"_35":16669,"_37":2333,"_39":16670,"_63":16671,"_65":16676,"_67":66},"_jXyvbnS",{"_2719":2972},[16672],{"_33":2751,"_2788":16673,"_2790":16674,"_39":16675,"_67":66},[2905,2866],[2907,2890],{},"What web loadResource adds (via loadResourcePayload)",{"_29":16678,"_31":16719},[16679,16690,16701,16712],{"_29":16680,"_31":16681},[],{"_33":2680,"_35":16682,"_37":2333,"_39":16683,"_63":16684,"_65":16689,"_67":66},"r7Oi9iT_",{},[16685],{"_33":2751,"_2788":16686,"_2790":16687,"_39":16688,"_67":66},[7514],[2836],{},"Same name loadResource means different things (desktop returns raw, web returns with author metadata)",{"_29":16691,"_31":16692},[],{"_33":2680,"_35":16693,"_37":2333,"_39":16694,"_63":16695,"_65":16700,"_67":66},"HMwkR0N2",{},[16696],{"_33":2751,"_2788":16697,"_2790":16698,"_39":16699,"_67":66},[144,6424,8080],[2551,8223,8321],{},"createResourceLoader throws on error, but desktop's loadResource catches and returns not-found",{"_29":16702,"_31":16703},[],{"_33":2680,"_35":16704,"_37":2333,"_39":16705,"_63":16706,"_65":16711,"_67":66},"4W-dhDH6",{},[16707],{"_33":2751,"_2788":16708,"_2790":16709,"_39":16710,"_67":66},[2805,4245],[1330,8222],{},"Web has both getResource AND loadResource making duplicate GRPC calls",{"_29":16713,"_31":16714},[],{"_33":2680,"_35":16715,"_37":2333,"_39":16716,"_63":16717,"_65":16718,"_67":66},"hXqiWvpz",{},[],"No clear naming for abstraction levels",{"_33":3020,"_35":16720,"_37":2333,"_39":16721,"_63":16722,"_65":16723,"_67":66},"P5cTOwVh",{"_2719":2972},[],"Why It's Confusing",{"_33":3020,"_35":16725,"_37":2333,"_39":16726,"_63":16727,"_65":9373,"_67":66},"rb0tholt",{"_2719":243},[],{"_29":16729,"_31":16977},[16730,16737,16773,16806,16896],{"_29":16731,"_31":16732},[],{"_33":2680,"_35":16733,"_37":2333,"_39":16734,"_63":16735,"_65":16736,"_67":66},"XAFESVhh",{},[],"Note: this is more about \"re-organizing\" than \"refactoring\", so it shouldn't be a very dramatic change. But it should hopefully help us understand what functions are responsible for what.",{"_29":16738,"_31":16764},[16739,16757],{"_29":16740,"_31":16741},[],{"_33":2680,"_35":16742,"_37":2333,"_39":16743,"_63":16744,"_65":16756,"_67":66},"8P9FXpfG",{},[16745,16750],{"_33":3084,"_2788":16746,"_2790":16747,"_39":16749,"_67":66},[144,8079,2824,10672],[2805,6790,16748,7538],125,{},{"_33":2751,"_2788":16751,"_2790":16753,"_39":16755,"_67":66},[175,6674,16752,6383],163,[7724,6675,16754,11859],173,{},"What it does: GRPC call, parse response, return typed result Redirects: Returns {type: 'redirect', redirectTarget} Not found: Returns {type: 'not-found'} Returns: HMResource = document | comment | redirect | not-found",{"_29":16758,"_31":16759},[],{"_33":2751,"_35":16760,"_37":2333,"_39":16761,"_63":16762,"_65":16763,"_67":66},"zFIXMaXw",{"_2753":13245},[],"// Desktop, API endpoints, simple lookups\nconst resource = await fetchResource(id)\nif (resource.type === 'document') { /* use resource.document */ }\nif (resource.type === 'redirect') { /* caller decides what to do */ }\nif (resource.type === 'not-found') { /* caller decides what to do */ }\n",{"_33":3020,"_35":16765,"_37":2333,"_39":16766,"_63":16767,"_65":16772,"_67":66},"TTAr-6tv",{"_2719":243},[16768],{"_33":2751,"_2788":16769,"_2790":16770,"_39":16771,"_67":66},[144],[2805],{},"fetchResource (lowest level)",{"_29":16774,"_31":16797},[16775,16790],{"_29":16776,"_31":16777},[],{"_33":2680,"_35":16778,"_37":2333,"_39":16779,"_63":16780,"_65":16789,"_67":66},"SAPR28UK",{},[16781,16785],{"_33":3084,"_2788":16782,"_2790":16783,"_39":16784,"_67":66},[144,10108,9385,10237],[2805,6426,11485,340],{},{"_33":2751,"_2788":16786,"_2790":16787,"_39":16788,"_67":66},[11304,6387,8789],[8449,11114,8247],{},"What it does: Fetches and follows redirects until final target Redirects: Follows automatically (recursive) Not found: Throws HMNotFoundError Returns: HMResolvedResource = document | comment (never redirect)",{"_29":16791,"_31":16792},[],{"_33":2751,"_35":16793,"_37":2333,"_39":16794,"_63":16795,"_65":16796,"_67":66},"IOzFIhYY",{"_2753":13245},[],"// When you need final target, don't care about redirect chain\nconst resource = await resolveResource(id)\n// resource.type is 'document' or 'comment', never 'redirect'\n",{"_33":3020,"_35":16798,"_37":2333,"_39":16799,"_63":16800,"_65":16805,"_67":66},"3goif2ck",{"_2719":243},[16801],{"_33":2751,"_2788":16802,"_2790":16803,"_39":16804,"_67":66},[144],[2087],{},"resolveResource (mid level)",{"_29":16807,"_31":16887},[16808,16872],{"_29":16809,"_31":16863},[16810,16817,16824,16831,16838,16845,16852],{"_29":16811,"_31":16812},[],{"_33":2680,"_35":16813,"_37":2333,"_39":16814,"_63":16815,"_65":16816,"_67":66},"FJs76hEt",{},[],"Author metadata (name, avatar for each author uid)",{"_29":16818,"_31":16819},[],{"_33":2680,"_35":16820,"_37":2333,"_39":16821,"_63":16822,"_65":16823,"_67":66},"_nY-MUK0",{},[],"Breadcrumb navigation (parent path titles)",{"_29":16825,"_31":16826},[],{"_33":2680,"_35":16827,"_37":2333,"_39":16828,"_63":16829,"_65":16830,"_67":66},"_G-SyvLY",{},[],"Support documents (embedded/referenced docs for rendering)",{"_29":16832,"_31":16833},[],{"_33":2680,"_35":16834,"_37":2333,"_39":16835,"_63":16836,"_65":16837,"_67":66},"OFg1-f7n",{},[],"Support queries (query block results)",{"_29":16839,"_31":16840},[],{"_33":2680,"_35":16841,"_37":2333,"_39":16842,"_63":16843,"_65":16844,"_67":66},"QQFLALkr",{},[],"Directory results (doc children for nav)",{"_29":16846,"_31":16847},[],{"_33":2680,"_35":16848,"_37":2333,"_39":16849,"_63":16850,"_65":16851,"_67":66},"CxhCnJGp",{},[],"Home document + directory (for site header nav)",{"_29":16853,"_31":16854},[],{"_33":2680,"_35":16855,"_37":2333,"_39":16856,"_63":16857,"_65":16862,"_67":66},"9p_a8eiF",{},[16858],{"_33":2751,"_2788":16859,"_2790":16860,"_39":16861,"_67":66},[144],[1057],{},"isLatest flag",{"_33":2680,"_35":16864,"_37":2333,"_39":16865,"_63":16866,"_65":16871,"_67":66},"9BGmpND-",{"_2719":2972},[16867],{"_33":3084,"_2788":16868,"_2790":16869,"_39":16870,"_67":66},[144],[2805],{},"What it does: Resolves, triggers P2P discovery on not-found, adds:",{"_29":16873,"_31":16874},[],{"_33":2680,"_35":16875,"_37":2333,"_39":16876,"_63":16877,"_65":16886,"_67":66},"J_1ArpPJ",{},[16878,16882],{"_33":3084,"_2788":16879,"_2790":16880,"_39":16881,"_67":66},[144,6695,8547],[7514,2966,8281],{},{"_33":2751,"_2788":16883,"_2790":16884,"_39":16885,"_67":66},[8080],[7521],{},"Redirects: Follows automatically Not found: Triggers P2P discovery, retries Returns: WebResourcePayload",{"_33":3020,"_35":16888,"_37":2333,"_39":16889,"_63":16890,"_65":16895,"_67":66},"bGwFK1oU",{"_2719":243},[16891],{"_33":2751,"_2788":16892,"_2790":16893,"_39":16894,"_67":66},[144],[2965],{},"loadResource (web, highest level)",{"_29":16897,"_31":16968},[16898,16953],{"_29":16899,"_31":16940},[16900,16911,16922,16933],{"_29":16901,"_31":16902},[],{"_33":2680,"_35":16903,"_37":2333,"_39":16904,"_63":16905,"_65":16910,"_67":66},"7ApxdiqT",{},[16906],{"_33":2751,"_2788":16907,"_2790":16908,"_39":16909,"_67":66},[144],[2965],{},"homeMetadata (site name, icon, theme from account root)",{"_29":16912,"_31":16913},[],{"_33":2680,"_35":16914,"_37":2333,"_39":16915,"_63":16916,"_65":16921,"_67":66},"sAbW9oNl",{},[16917],{"_33":2751,"_2788":16918,"_2790":16919,"_39":16920,"_67":66},[144],[2965],{},"originHomeId (site root account id)",{"_29":16923,"_31":16924},[],{"_33":2680,"_35":16925,"_37":2333,"_39":16926,"_63":16927,"_65":16932,"_67":66},"nVVa_Bfl",{},[16928],{"_33":2751,"_2788":16929,"_2790":16930,"_39":16931,"_67":66},[144],[649],{},"origin (request origin URL)",{"_29":16934,"_31":16935},[],{"_33":2680,"_35":16936,"_37":2333,"_39":16937,"_63":16938,"_65":16939,"_67":66},"8z3M0wTN",{},[],"Error fallback (loads home doc even on error so header renders)",{"_33":2680,"_35":16941,"_37":2333,"_39":16942,"_63":16943,"_65":16952,"_67":66},"eecUpxsA",{"_2719":2972},[16944,16948],{"_33":3084,"_2788":16945,"_2790":16946,"_39":16947,"_67":66},[144],[2805],{},{"_33":2751,"_2788":16949,"_2790":16950,"_39":16951,"_67":66},[2551],[2866],{},"What it does: Calls loadResource + adds:",{"_29":16954,"_31":16955},[],{"_33":2680,"_35":16956,"_37":2333,"_39":16957,"_63":16958,"_65":16967,"_67":66},"dEvwNGJA",{},[16959,16963],{"_33":3084,"_2788":16960,"_2790":16961,"_39":16962,"_67":66},[144],[1057],{},{"_33":2751,"_2788":16964,"_2790":16965,"_39":16966,"_67":66},[2905],[2889],{},"Returns: SiteDocumentPayload",{"_33":3020,"_35":16969,"_37":2333,"_39":16970,"_63":16971,"_65":16976,"_67":66},"7vBHLStd",{"_2719":243},[16972],{"_33":2751,"_2788":16973,"_2790":16974,"_39":16975,"_67":66},[144],[1182],{},"loadSiteResource (web, wraps loadResource)",{"_33":3020,"_35":16978,"_37":2333,"_39":16979,"_63":16980,"_65":16981,"_67":66},"fC208cUZ",{"_2719":243},[],"New Pattern: fetch → resolve → load",[72],"/tech-talks/resource-loading-organization",{"_84":2349},{},{"_90":2333,"_94":2347},{"_35":2330,"_102":51,"_52":16988,"_68":2333,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2332],1779255260575,[156,2330,2333,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/resource-loading-organization\",\"bafy2bzacebewlsbwwc733rfg23wcnz6vgseuhp6cfuvppsf6flkqavher2xgq\",true]",{"_117":16993,"_154":17063,"_157":17064},{"_119":16994,"_139":42,"_140":17062,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":16995,"_35":17060},{"_26":16996,"_68":2355,"_69":51,"_70":17055,"_52":17056,"_78":2362,"_80":2362,"_82":17057,"_88":17058,"_90":2355,"_92":17059,"_96":97},[16997,17004,17026,17037,17048],{"_29":16998,"_31":16999},[],{"_33":2680,"_35":17000,"_37":2355,"_39":17001,"_63":17002,"_65":17003,"_67":66},"uOPL87My",{},[],"In our backend code I've seen a bunch of places where we compare the result of an expression with an input parameter/s.",{"_29":17005,"_31":17021},[17006,17014],{"_29":17007,"_31":17008},[],{"_33":2751,"_35":17009,"_37":2355,"_39":17010,"_63":17012,"_65":17013,"_67":66},"n1_t6w8O",{"_2753":17011},"sql",[],"SELECT\n id\nFROM public_keys\nWHERE hex(principal) = :principal LIMIT 1;",{"_29":17015,"_31":17016},[],{"_33":2751,"_35":17017,"_37":2355,"_39":17018,"_63":17019,"_65":17020,"_67":66},"rnD8Aiar",{"_2753":17011},[],"SELECT DISTINCT\n multihash,\n codec\nFROM blobs\nWHERE hex(multihash) IN (\n SELECT value from json_each(:mhash_json)\n)\nAND size > 0",{"_33":2680,"_35":17022,"_37":2355,"_39":17023,"_63":17024,"_65":17025,"_67":66},"O4BttVFb",{"_2719":243},[],"For example:",{"_29":17027,"_31":17028},[],{"_33":2680,"_35":17029,"_37":2355,"_39":17030,"_63":17031,"_65":17036,"_67":66},"DEE-HKih",{},[17032],{"_33":2751,"_2788":17033,"_2790":17034,"_39":17035,"_67":66},[4245,340],[2792,8451],{},"In both of these queries the WHERE clause can't use an index, and will do a full table scan. This is because the index doesn't know the result of the hex() expression, so it can't compare the column value against the input parameter.",{"_29":17038,"_31":17039},[],{"_33":2680,"_35":17040,"_37":2355,"_39":17041,"_63":17042,"_65":17047,"_67":66},"TIHMi81A",{},[17043],{"_33":2751,"_2788":17044,"_2790":17045,"_39":17046,"_67":66},[783,7712],[6802,467],{},"The solution for the first query is to do WHERE principal = unhex(:principal) and for the second one is to do WHERE multihash IN (SELECT unhex(value) FROM json_each(:mhash_json).",{"_29":17049,"_31":17050},[],{"_33":2680,"_35":17051,"_37":2355,"_39":17052,"_63":17053,"_65":17054,"_67":66},"QHFwP2nu",{},[],"So, instead of running an expression on all the rows in the table, we run the \"reverse\" expression to convert the input parameter to the same value as the column, which will let us use the index.",[183],"/tech-talks/sqlite-avoid-comparing-against-expressions",{"_84":2371},{},{"_90":2355,"_94":2369},{"_35":2352,"_102":51,"_52":17061,"_68":2355,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2354],1779255260541,[156,2352,2355,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/sqlite-avoid-comparing-against-expressions\",\"bafy2bzacecmometxom6jy3blvvtlna5fbcvnzypu6oojunl56wcyt5hjwdpds\",true]",{"_117":17066,"_154":17291,"_157":17292},{"_119":17067,"_139":42,"_140":17290,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":17068,"_35":17288},{"_26":17069,"_68":2377,"_69":51,"_70":17282,"_52":17283,"_78":2385,"_80":17284,"_82":17285,"_88":17286,"_90":2386,"_92":17287,"_96":97},[17070,17092,17132,17182,17261],{"_29":17071,"_31":17083},[17072],{"_29":17073,"_31":17074},[],{"_33":2680,"_35":17075,"_37":2377,"_39":17076,"_63":17077,"_65":17082,"_67":66},"ptesScc6",{},[17078],{"_33":3084,"_2788":17079,"_2790":17080,"_39":17081,"_67":66},[6572],[6386],{},"Backend is taking over sync responsibility. New API: pushResourcesToPeer.\nFrontend (TS) will start calling it whenever a document-related change needs to be pushed to a peer.",{"_33":3020,"_35":17084,"_37":2386,"_39":17085,"_63":17086,"_65":17091,"_67":66},"W-M74EKa",{"_2719":243},[17087],{"_33":3084,"_2788":17088,"_2790":17089,"_39":17090,"_67":66},[144],[2965],{},"What changed",{"_29":17093,"_31":17123},[17094,17105,17116],{"_29":17095,"_31":17096},[],{"_33":2680,"_35":17097,"_37":2386,"_39":17098,"_63":17099,"_65":17104,"_67":66},"oSNCI7UJ",{},[17100],{"_33":3084,"_2788":17101,"_2790":17102,"_39":17103,"_67":66},[7518],[2853],{},"Frontend integration is straightforward; test on devnet after merge.",{"_29":17106,"_31":17107},[],{"_33":2680,"_35":17108,"_37":2386,"_39":17109,"_63":17110,"_65":17115,"_67":66},"_LQ-SrZa",{},[17111],{"_33":3084,"_2788":17112,"_2790":17113,"_39":17114,"_67":66},[144],[6424],{},"No DB migration. No mandatory protocol version bump.",{"_29":17117,"_31":17118},[],{"_33":2680,"_35":17119,"_37":2386,"_39":17120,"_63":17121,"_65":17122,"_67":66},"7J5hZn6a",{},[],"Reverting is easy.",{"_33":3020,"_35":17124,"_37":2386,"_39":17125,"_63":17126,"_65":17131,"_67":66},"CLWPflQr",{"_2719":2972},[17127],{"_33":3084,"_2788":17128,"_2790":17129,"_39":17130,"_67":66},[144],[2821],{},"Testing + rollout",{"_29":17133,"_31":17169},[17134,17141,17148,17155,17162],{"_29":17135,"_31":17136},[],{"_33":2680,"_35":17137,"_37":2386,"_39":17138,"_63":17139,"_65":17140,"_67":66},"DHsKwNMF",{},[],"New comment",{"_29":17142,"_31":17143},[],{"_33":2680,"_35":17144,"_37":2386,"_39":17145,"_63":17146,"_65":17147,"_67":66},"NXUtALrm",{},[],"User copies URL (share flow)",{"_29":17149,"_31":17150},[],{"_33":2680,"_35":17151,"_37":2386,"_39":17152,"_63":17153,"_65":17154,"_67":66},"4Z7L-P3J",{},[],"Document publish",{"_29":17156,"_31":17157},[],{"_33":2680,"_35":17158,"_37":2386,"_39":17159,"_63":17160,"_65":17161,"_67":66},"2QzZ2WrS",{},[],"Document delete",{"_29":17163,"_31":17164},[],{"_33":2680,"_35":17165,"_37":2386,"_39":17166,"_63":17167,"_65":17168,"_67":66},"2x0bbBLJ",{},[],"Document move+redirect (call for both old + new locations)",{"_33":3020,"_35":17170,"_37":2386,"_39":17171,"_63":17172,"_65":17181,"_67":66},"iEWvPwwo",{"_2719":2972},[17173,17177],{"_33":3084,"_2788":17174,"_2790":17175,"_39":17176,"_67":66},[144],[2889],{},{"_33":2751,"_2788":17178,"_2790":17179,"_39":17180,"_67":66},[2889],[3088],{},"When the frontend must call pushResourcesToPeer",{"_29":17183,"_31":17252},[17184,17195,17202],{"_29":17185,"_31":17186},[],{"_33":2680,"_35":17187,"_37":2386,"_39":17188,"_63":17189,"_65":17194,"_67":66},"3E21wsgT",{},[17190],{"_33":3084,"_2788":17191,"_2790":17192,"_39":17193,"_67":66},[6289],[2818],{},"Comments referencing other docs (A references B) require pushes for each referenced doc’s home server, so backlinks propagate correctly for self-hosters.",{"_29":17196,"_31":17197},[],{"_33":2680,"_35":17198,"_37":2386,"_39":17199,"_63":17200,"_65":17201,"_67":66},"edzzDAsW",{},[],"Same for doc-to-doc references.",{"_29":17203,"_31":17243},[17204,17211,17218,17225,17232],{"_29":17205,"_31":17206},[],{"_33":2680,"_35":17207,"_37":2386,"_39":17208,"_63":17209,"_65":17210,"_67":66},"OcytJbFz",{},[],"Alex half-jokes about backend auto-pushing all blobs, but it doesn’t know the target site, and frontend needs to show progress/spinner.",{"_29":17212,"_31":17213},[],{"_33":2680,"_35":17214,"_37":2386,"_39":17215,"_63":17216,"_65":17217,"_67":66},"KPFtLCJl",{},[],"periodic syncing does not support private docs, so push is even more important.",{"_29":17219,"_31":17220},[],{"_33":2680,"_35":17221,"_37":2386,"_39":17222,"_63":17223,"_65":17224,"_67":66},"fzJQeghx",{},[],"Worry: pushing to every referenced doc could become spammy.",{"_29":17226,"_31":17227},[],{"_33":2680,"_35":17228,"_37":2386,"_39":17229,"_63":17230,"_65":17231,"_67":66},"rYlpx2wn",{},[],"Counterpoint: self-hosters relying on federation/backlinks will break without this.",{"_29":17233,"_31":17234},[],{"_33":2680,"_35":17235,"_37":2386,"_39":17236,"_63":17237,"_65":17242,"_67":66},"JOJlLKZC",{},[17238],{"_33":9788,"_2788":17239,"_2790":17240,"_39":17241,"_67":66},[754],[6790],{},"Agreement: backlinks should only be expected within trust relationships (web-of-trust), not “the whole universe.”",{"_33":3020,"_35":17244,"_37":2386,"_39":17245,"_63":17246,"_65":17251,"_67":66},"e98TeJIf",{"_2719":2972},[17247],{"_33":3084,"_2788":17248,"_2790":17249,"_39":17250,"_67":66},[144],[8172],{},"Disagreements / nuances",{"_33":3020,"_35":17253,"_37":2386,"_39":17254,"_63":17255,"_65":17260,"_67":66},"RdfUPlAC",{"_2719":243},[17256],{"_33":3084,"_2788":17257,"_2790":17258,"_39":17259,"_67":66},[144],[2821],{},"Extra realization",{"_29":17262,"_31":17274},[17263],{"_29":17264,"_31":17265},[],{"_33":2680,"_35":17266,"_37":2386,"_39":17267,"_63":17268,"_65":17273,"_67":66},"5t8Ijoxm",{},[17269],{"_33":3084,"_2788":17270,"_2790":17271,"_39":17272,"_67":66},[2836],[10108],{},"Feature is doable but the TS side is more complex than expected because pushes must cover the primary document + all reference targets to keep federation/backlinks consistent for trusted self-hosted peers.",{"_33":3020,"_35":17275,"_37":2386,"_39":17276,"_63":17277,"_65":11907,"_67":66},"ELN8A7iH",{"_2719":243},[17278],{"_33":3084,"_2788":17279,"_2790":17280,"_39":17281,"_67":66},[144],[7514],{},[72],"/tech-talks/pushresourcestopeer-api-rollout","2025-11-20T11:19:12.945Z",{"_84":2399},{},{"_90":2386,"_94":2397},{"_35":2374,"_102":51,"_52":17289,"_68":2377,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2376],1779255260504,[156,2374,2377,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/pushresourcestopeer-api-rollout\",\"bafy2bzacedp6smaulc5wzajs54digmhu5i5dwqwltxllza2nmpu5dowwzrrwg\",true]",{"_117":17294,"_154":17766,"_157":17767},{"_119":17295,"_139":42,"_140":17765,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":17296,"_35":17763},{"_26":17297,"_68":2405,"_69":51,"_70":17757,"_52":17758,"_78":2414,"_80":17759,"_82":17760,"_88":17761,"_90":2415,"_92":17762,"_96":97},[17298,17431,17492,17673,17715],{"_29":17299,"_31":17425},[17300,17318,17343,17368,17397],{"_29":17301,"_31":17313},[17302],{"_29":17303,"_31":17304},[],{"_33":2680,"_35":17305,"_37":2415,"_39":17306,"_63":17307,"_65":17312,"_67":66},"R_XB42PB",{},[17308],{"_33":3084,"_2788":17309,"_2790":17310,"_39":17311,"_67":66},[144],[2907],{},"8 physical CPU cores\n(Intel i7/i9, Xeon-W, AMD Ryzen 7/9, Threadripper-class optional)",{"_33":3020,"_35":17314,"_37":2415,"_39":17315,"_63":17316,"_65":17317,"_67":66},"wNtcU7Lf",{"_2719":2972},[],"CPU",{"_29":17319,"_31":17338},[17320,17331],{"_29":17321,"_31":17322},[],{"_33":2680,"_35":17323,"_37":2415,"_39":17324,"_63":17325,"_65":17330,"_67":66},"LM_4mz2d",{},[17326],{"_33":3084,"_2788":17327,"_2790":17328,"_39":17329,"_67":66},[144],[2839],{},"32 GB DDR4/DDR5 RAM",{"_29":17332,"_31":17333},[],{"_33":2680,"_35":17334,"_37":2415,"_39":17335,"_63":17336,"_65":17337,"_67":66},"Be3bokA_",{},[],"ECC optional but recommended",{"_33":3020,"_35":17339,"_37":2415,"_39":17340,"_63":17341,"_65":17342,"_67":66},"3mnPsl40",{"_2719":2972},[],"Memory",{"_29":17344,"_31":17363},[17345,17356],{"_29":17346,"_31":17347},[],{"_33":2680,"_35":17348,"_37":2415,"_39":17349,"_63":17350,"_65":17355,"_67":66},"v60Vdgyz",{},[17351],{"_33":3084,"_2788":17352,"_2790":17353,"_39":17354,"_67":66},[144],[1057],{},"1 TB SSD (SATA or NVMe; NVMe preferred but not required)",{"_29":17357,"_31":17358},[],{"_33":2680,"_35":17359,"_37":2415,"_39":17360,"_63":17361,"_65":17362,"_67":66},"p_ELzbDa",{},[],"No mechanical HDDs",{"_33":3020,"_35":17364,"_37":2415,"_39":17365,"_63":17366,"_65":17367,"_67":66},"RlemxgBz",{"_2719":2972},[],"Storage (SSD Only)",{"_29":17369,"_31":17392},[17370,17381],{"_29":17371,"_31":17372},[],{"_33":2680,"_35":17373,"_37":2415,"_39":17374,"_63":17375,"_65":17380,"_67":66},"BXzRt7UR",{},[17376],{"_33":3084,"_2788":17377,"_2790":17378,"_39":17379,"_67":66},[144],[2821],{},">=1 Gbps Ethernet",{"_29":17382,"_31":17383},[],{"_33":2680,"_35":17384,"_37":2415,"_39":17385,"_63":17386,"_65":17391,"_67":66},"nMxkolod",{},[17387],{"_33":3084,"_2788":17388,"_2790":17389,"_39":17390,"_67":66},[2965],[2920],{},"Support for static IPv4/IPv6 assignment",{"_33":3020,"_35":17393,"_37":2415,"_39":17394,"_63":17395,"_65":17396,"_67":66},"ryvTRFw-",{"_2719":2972},[],"Network Interface",{"_29":17398,"_31":17420},[17399,17406,17413],{"_29":17400,"_31":17401},[],{"_33":2680,"_35":17402,"_37":2415,"_39":17403,"_63":17404,"_65":17405,"_67":66},"KjMiDwYS",{},[],"Tower-workstation or small-form workstation",{"_29":17407,"_31":17408},[],{"_33":2680,"_35":17409,"_37":2415,"_39":17410,"_63":17411,"_65":17412,"_67":66},"Vjnh4CUc",{},[],"500–750W PSU",{"_29":17414,"_31":17415},[],{"_33":2680,"_35":17416,"_37":2415,"_39":17417,"_63":17418,"_65":17419,"_67":66},"xdaou085",{},[],"UPS recommended if not in a datacenter",{"_33":3020,"_35":17421,"_37":2415,"_39":17422,"_63":17423,"_65":17424,"_67":66},"TZwyz3OG",{"_2719":2972},[],"Power / Form Factor",{"_33":3020,"_35":17426,"_37":17427,"_39":17428,"_63":17429,"_65":17430,"_67":66},"G0J4Px28","bafy2bzaceca6ywi7v523pug5a4pcbugpssmu2r5msxke6hlhr3dqw44ly5x7q",{"_2719":243},[],"1. Hardware Requirements",{"_29":17432,"_31":17487},[17433,17458],{"_29":17434,"_31":17453},[17435,17446],{"_29":17436,"_31":17437},[],{"_33":2680,"_35":17438,"_37":2415,"_39":17439,"_63":17440,"_65":17445,"_67":66},"52mcQdJJ",{},[17441],{"_33":3084,"_2788":17442,"_2790":17443,"_39":17444,"_67":66},[144],[2821],{},"Ubuntu Server LTS (24.04)",{"_29":17447,"_31":17448},[],{"_33":2680,"_35":17449,"_37":2415,"_39":17450,"_63":17451,"_65":17452,"_67":66},"2dgyrh6f",{},[],"Minimal installation + SSH enabled",{"_33":3020,"_35":17454,"_37":2415,"_39":17455,"_63":17456,"_65":17457,"_67":66},"YiPZkoMK",{"_2719":2972},[],"OS",{"_29":17459,"_31":17482},[17460,17471],{"_29":17461,"_31":17462},[],{"_33":2680,"_35":17463,"_37":2415,"_39":17464,"_63":17465,"_65":17470,"_67":66},"vicrD991",{},[17466],{"_33":3084,"_2788":17467,"_2790":17468,"_39":17469,"_67":66},[144],[2805],{},"Docker Engine",{"_29":17472,"_31":17473},[],{"_33":2680,"_35":17474,"_37":2415,"_39":17475,"_63":17476,"_65":17481,"_67":66},"PmR30cUW",{},[17477],{"_33":3084,"_2788":17478,"_2790":17479,"_39":17480,"_67":66},[144],[2839],{},"Docker Compose (v2)",{"_33":3020,"_35":17483,"_37":2415,"_39":17484,"_63":17485,"_65":17486,"_67":66},"j1f4Y9Cr",{"_2719":2972},[],"Container Runtime",{"_33":3020,"_35":17488,"_37":17427,"_39":17489,"_63":17490,"_65":17491,"_67":66},"fOdN2Yze",{"_2719":243},[],"2. Operating System & Software",{"_29":17493,"_31":17668},[17494,17519,17588],{"_29":17495,"_31":17514},[17496,17507],{"_29":17497,"_31":17498},[],{"_33":2680,"_35":17499,"_37":2415,"_39":17500,"_63":17501,"_65":17506,"_67":66},"tBXQ60qn",{},[17502],{"_33":3084,"_2788":17503,"_2790":17504,"_39":17505,"_67":66},[2839],[2889],{},"They must assign a static IP for the workstation server.",{"_29":17508,"_31":17509},[],{"_33":2680,"_35":17510,"_37":2415,"_39":17511,"_63":17512,"_65":17513,"_67":66},"XJnvFq5i",{},[],"The IP must be reachable from inside their network;",{"_33":3020,"_35":17515,"_37":2415,"_39":17516,"_63":17517,"_65":17518,"_67":66},"6__yNmwS",{"_2719":2972},[],"Static IP Address",{"_29":17520,"_31":17583},[17521,17554],{"_29":17522,"_31":17549},[17523,17538],{"_29":17524,"_31":17525},[],{"_33":2680,"_35":17526,"_37":2415,"_39":17527,"_63":17528,"_65":17537,"_67":66},"BgKlQbGz",{},[17529,17533],{"_33":3084,"_2788":17530,"_2790":17531,"_39":17532,"_67":66},[516],[1300],{},{"_33":2751,"_2788":17534,"_2790":17535,"_39":17536,"_67":66},[2839,2866],[491,6424],{},"A subdomain (e.g., seed.ucm.es, seed.sheffield.ac.uk)",{"_29":17539,"_31":17540},[],{"_33":2680,"_35":17541,"_37":2415,"_39":17542,"_63":17543,"_65":17548,"_67":66},"0C1ipH1b",{},[17544],{"_33":3084,"_2788":17545,"_2790":17546,"_39":17547,"_67":66},[2965],[2551],{},"A dedicated A record pointed to the server’s static IP",{"_33":2680,"_35":17550,"_37":2415,"_39":17551,"_63":17552,"_65":17553,"_67":66},"15tmQGAk",{"_2719":2972},[],"They must provide:",{"_29":17555,"_31":17578},[17556,17567],{"_29":17557,"_31":17558},[],{"_33":2680,"_35":17559,"_37":2415,"_39":17560,"_63":17561,"_65":17566,"_67":66},"dCgFYKc3",{},[17562],{"_33":3084,"_2788":17563,"_2790":17564,"_39":17565,"_67":66},[144],[1057],{},"A record → IPv4 of the server",{"_29":17568,"_31":17569},[],{"_33":2680,"_35":17570,"_37":2415,"_39":17571,"_63":17572,"_65":17577,"_67":66},"W_HUCxN2",{},[17573],{"_33":3084,"_2788":17574,"_2790":17575,"_39":17576,"_67":66},[144],[390],{},"CNAME ",{"_33":2680,"_35":17579,"_37":2415,"_39":17580,"_63":17581,"_65":17582,"_67":66},"YmO81JE1",{"_2719":2972},[],"They must be able to add the DNS records:",{"_33":3020,"_35":17584,"_37":2415,"_39":17585,"_63":17586,"_65":17587,"_67":66},"57sjJnJ6",{"_2719":2972},[],"Domain Name / Subdomain",{"_29":17589,"_31":17663},[17590,17601,17608],{"_29":17591,"_31":17592},[],{"_33":2680,"_35":17593,"_37":2415,"_39":17594,"_63":17595,"_65":17600,"_67":66},"XZ9KUcc-",{},[17596],{"_33":3084,"_2788":17597,"_2790":17598,"_39":17599,"_67":66},[2965],[2966],{},"Seed uses a non-standard ports: 56000-56002.",{"_29":17602,"_31":17603},[],{"_33":2680,"_35":17604,"_37":2415,"_39":17605,"_63":17606,"_65":17607,"_67":66},"aSSqLORC",{},[],"They must allow the following:",{"_29":17609,"_31":17654},[17610],{"_29":17611,"_31":17645},[17612,17623,17634],{"_29":17613,"_31":17614},[],{"_33":2680,"_35":17615,"_37":2415,"_39":17616,"_63":17617,"_65":17622,"_67":66},"oc_41XgX",{},[17618],{"_33":3084,"_2788":17619,"_2790":17620,"_39":17621,"_67":66},[1057],[2839],{},"TCP/UDP 56000-56002 → required by Seed (primary application port)",{"_29":17624,"_31":17625},[],{"_33":2680,"_35":17626,"_37":2415,"_39":17627,"_63":17628,"_65":17633,"_67":66},"GK_VhUhh",{},[17629],{"_33":3084,"_2788":17630,"_2790":17631,"_39":17632,"_67":66},[1835],[649],{},"TCP 22 → SSH administration (should be limited to IT staff only)",{"_29":17635,"_31":17636},[],{"_33":2680,"_35":17637,"_37":2415,"_39":17638,"_63":17639,"_65":17644,"_67":66},"bykGnkNU",{},[17640],{"_33":3084,"_2788":17641,"_2790":17642,"_39":17643,"_67":66},[1835],[7514],{},"TCP 80/443 → if using HTTP/HTTPS proxying in front of port 56000",{"_33":2680,"_35":17646,"_37":2415,"_39":17647,"_63":17648,"_65":17653,"_67":66},"KBupVCBs",{"_2719":2972},[17649],{"_33":3084,"_2788":17650,"_2790":17651,"_39":17652,"_67":66},[144],[1057],{},"Inbound:",{"_33":2680,"_35":17655,"_37":2415,"_39":17656,"_63":17657,"_65":17662,"_67":66},"cbg-u9WI",{"_2719":2972},[17658],{"_33":3084,"_2788":17659,"_2790":17660,"_39":17661,"_67":66},[144],[8172],{},"Firewall / Router Rules",{"_33":3020,"_35":17664,"_37":17427,"_39":17665,"_63":17666,"_65":17667,"_67":66},"AzM46nEW",{"_2719":243},[],"Port Requirements",{"_33":3020,"_35":17669,"_37":17427,"_39":17670,"_63":17671,"_65":17672,"_67":66},"kYMxi_ci",{"_2719":243},[],"3. Networking & Domain Requirements",{"_29":17674,"_31":17710},[17675,17682,17689,17696,17703],{"_29":17676,"_31":17677},[],{"_33":2680,"_35":17678,"_37":2415,"_39":17679,"_63":17680,"_65":17681,"_67":66},"ybroolxx",{},[],"Runs full Seed application inside Docker containers",{"_29":17683,"_31":17684},[],{"_33":2680,"_35":17685,"_37":2415,"_39":17686,"_63":17687,"_65":17688,"_67":66},"WClYkwkv",{},[],"SSD ensures fast I/O for logs and database",{"_29":17690,"_31":17691},[],{"_33":2680,"_35":17692,"_37":2415,"_39":17693,"_63":17694,"_65":17695,"_67":66},"fjsPB4lN",{},[],"Suitable for ~20–200 concurrent users",{"_29":17697,"_31":17698},[],{"_33":2680,"_35":17699,"_37":2415,"_39":17700,"_63":17701,"_65":17702,"_67":66},"7BArPARf",{},[],"No GPU needed",{"_29":17704,"_31":17705},[],{"_33":2680,"_35":17706,"_37":2415,"_39":17707,"_63":17708,"_65":17709,"_67":66},"_L_T0Sgr",{},[],"Works entirely on a single workstation-class machine",{"_33":3020,"_35":17711,"_37":2415,"_39":17712,"_63":17713,"_65":17714,"_67":66},"YefWLTu5",{"_2719":2972},[],"4. Application Hosting Requirements",{"_29":17716,"_31":17752},[17717,17738,17745],{"_29":17718,"_31":17733},[17719,17726],{"_29":17720,"_31":17721},[],{"_33":2680,"_35":17722,"_37":2415,"_39":17723,"_63":17724,"_65":17725,"_67":66},"qu3NEYUn",{},[],"Network share, or",{"_29":17727,"_31":17728},[],{"_33":2680,"_35":17729,"_37":2415,"_39":17730,"_63":17731,"_65":17732,"_67":66},"8LGyi2fV",{},[],"External server",{"_33":2680,"_35":17734,"_37":2415,"_39":17735,"_63":17736,"_65":17737,"_67":66},"aKedrIVA",{"_2719":2972},[],"Daily or weekly backing up Seed data (DB + media) to:",{"_29":17739,"_31":17740},[],{"_33":2680,"_35":17741,"_37":2415,"_39":17742,"_63":17743,"_65":17744,"_67":66},"F8HQX_Jn",{},[],"Monthly OS updates via package manager",{"_29":17746,"_31":17747},[],{"_33":2680,"_35":17748,"_37":2415,"_39":17749,"_63":17750,"_65":17751,"_67":66},"v2Ggy4FB",{},[],"Optional: basic monitoring",{"_33":3020,"_35":17753,"_37":2415,"_39":17754,"_63":17755,"_65":17756,"_67":66},"hsjg_QKJ",{"_2719":2972},[],"5. Backup & Maintenance",[73,75],"/tech-talks/server-specs","2025-11-06T17:38:59.930Z",{"_84":2424},{},{"_90":2415,"_94":2422},{"_35":2402,"_102":51,"_52":17764,"_68":2405,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2404],1779255260417,[156,2402,2405,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/server-specs\",\"bafy2bzacedsdj7fi4asf43uex75ozh2gkpjpu462e3ppehp2r2wojvw5w7dqs\",true]",{"_117":17769,"_154":18052,"_157":18053},{"_119":17770,"_139":42,"_140":18051,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":17771,"_35":18049},{"_26":17772,"_68":2430,"_69":51,"_70":18044,"_52":18045,"_78":2437,"_80":2437,"_82":18046,"_88":18047,"_90":2430,"_92":18048,"_96":97},[17773,17780,17796,17829,17880,17887,17920,17971,17978,17985],{"_29":17774,"_31":17775},[],{"_33":2680,"_35":17776,"_37":2430,"_39":17777,"_63":17778,"_65":17779,"_67":66},"uUMVgjx9",{},[],"Written by chatGPT5",{"_29":17781,"_31":17782},[],{"_33":2680,"_35":17783,"_37":2430,"_39":17784,"_63":17785,"_65":17795,"_67":66},"Sll_veAW",{},[17786,17790],{"_33":3084,"_2788":17787,"_2790":17788,"_39":17789,"_67":66},[6571],[6837],{},{"_33":204,"_2788":17791,"_2790":17792,"_39":17793,"_67":17794},[6848],[7724],{},"http://fetch.No","You’re trying to let Remix loaders and React Query (RQ) “own” the same data. That splits authority and guarantees flicker, stale props, and double-fetches. Pick a boss.",{"_29":17797,"_31":17824},[17798,17813],{"_29":17799,"_31":17800},[],{"_33":2680,"_35":17801,"_37":2430,"_39":17802,"_63":17803,"_65":17812,"_67":66},"iyhn5MDP",{},[17804,17808],{"_33":3084,"_2788":17805,"_2790":17806,"_39":17807,"_67":66},[144,2893],[2965,175],{},{"_33":2751,"_2788":17809,"_2790":17810,"_39":17811,"_67":66},[2806],[2822],{},"Remix loader: pushes JSON into useLoaderData(). Remix decides when to revalidate (navigations, mutations, focus, etc.).",{"_29":17814,"_31":17815},[],{"_33":2680,"_35":17816,"_37":2430,"_39":17817,"_63":17818,"_65":17823,"_67":66},"DL9r2Bjf",{},[17819],{"_33":3084,"_2788":17820,"_2790":17821,"_39":17822,"_67":66},[144,2551,2866,2878,2853,8234],[1300,3926,783,6572,6289,6569],{},"React Query: owns a cache, with timestamps, staleTime, invalidations, and optimistic updates.",{"_33":3020,"_35":17825,"_37":2430,"_39":17826,"_63":17827,"_65":17828,"_67":66},"S-WZDKWn",{"_2719":2972},[],"Two data models, one UI",{"_29":17830,"_31":17875},[17831,17842,17853,17864],{"_29":17832,"_31":17833},[],{"_33":2680,"_35":17834,"_37":2430,"_39":17835,"_63":17836,"_65":17841,"_67":66},"NULgNIAl",{},[17837],{"_33":3084,"_2788":17838,"_2790":17839,"_39":17840,"_67":66},[144],[1300],{},"Stale props: loader data freezes at navigation time while RQ mutates underneath.",{"_29":17843,"_31":17844},[],{"_33":2680,"_35":17845,"_37":2430,"_39":17846,"_63":17847,"_65":17852,"_67":66},"GziPkxbw",{},[17848],{"_33":3084,"_2788":17849,"_2790":17850,"_39":17851,"_67":66},[144],[2965],{},"Double fetch: loader runs on navigation; RQ refetches on mount because your query is “stale.”",{"_29":17854,"_31":17855},[],{"_33":2680,"_35":17856,"_37":2430,"_39":17857,"_63":17858,"_65":17863,"_67":66},"1xvNMs_L",{},[17859],{"_33":3084,"_2788":17860,"_2790":17861,"_39":17862,"_67":66},[144],[2821],{},"Conflicted writes: Remix revalidation repaints old loader data right after an RQ mutation unless you micromanage.",{"_29":17865,"_31":17866},[],{"_33":2680,"_35":17867,"_37":2430,"_39":17868,"_63":17869,"_65":17874,"_67":66},"KLduAINM",{},[17870],{"_33":3084,"_2788":17871,"_2790":17872,"_39":17873,"_67":66},[144],[2087],{},"Mental overhead: two invalidation systems, two lifecycles, zero fun.",{"_33":2680,"_35":17876,"_37":2430,"_39":17877,"_63":17878,"_65":17879,"_67":66},"42MmqEtO",{"_2719":2972},[],"Run both on the same slice and you get:",{"_29":17881,"_31":17882},[],{"_33":3020,"_35":17883,"_37":2430,"_39":17884,"_63":17885,"_65":17886,"_67":66},"l7kV3ZDf",{},[],"The workable pattern",{"_29":17888,"_31":17911},[17889,17900],{"_29":17890,"_31":17891},[],{"_33":2680,"_35":17892,"_37":2430,"_39":17893,"_63":17894,"_65":17899,"_67":66},"GhaF1Kp5",{},[17895],{"_33":2751,"_2788":17896,"_2790":17897,"_39":17898,"_67":66},[144],[6424],{},"export function shouldRevalidate() { return false; } (or conditionally).",{"_29":17901,"_31":17902},[],{"_33":2680,"_35":17903,"_37":2430,"_39":17904,"_63":17905,"_65":17910,"_67":66},"4QwbxC1r",{},[17906],{"_33":3084,"_2788":17907,"_2790":17908,"_39":17909,"_67":66},[6286],[783],{},"Or move volatile bits into resource routes and fetch them via RQ, keeping parent route loaders stable.",{"_33":2680,"_35":17912,"_37":2430,"_39":17913,"_63":17914,"_65":17919,"_67":66},"3KEB0_hv",{"_2719":2972},[17915],{"_33":3084,"_2788":17916,"_2790":17917,"_39":17918,"_67":66},[491],[2890],{},"If you insist on SSR + RQ, do SSR hydration with RQ and stop reading loader data in the component.",{"_29":17921,"_31":17966},[17922,17933,17944,17955],{"_29":17923,"_31":17924},[],{"_33":2680,"_35":17925,"_37":2430,"_39":17926,"_63":17927,"_65":17932,"_67":66},"7SCofR9d",{},[17928],{"_33":2751,"_2788":17929,"_2790":17930,"_39":17931,"_67":66},[882,3088],[2836,2853],{},"Mixing useLoaderData() into UI that also calls useQuery for the same entity.",{"_29":17934,"_31":17935},[],{"_33":2680,"_35":17936,"_37":2430,"_39":17937,"_63":17938,"_65":17943,"_67":66},"OCjC84U0",{},[17939],{"_33":2751,"_2788":17940,"_2790":17941,"_39":17942,"_67":66},[7514],[2918],{},"Different queryKeys server vs client → hydration mismatch → double fetch.",{"_29":17945,"_31":17946},[],{"_33":2680,"_35":17947,"_37":2430,"_39":17948,"_63":17949,"_65":17954,"_67":66},"vxFWx5cR",{},[17950],{"_33":2751,"_2788":17951,"_2790":17952,"_39":17953,"_67":66},[170],[2965],{},"No staleTime → instant refetch on mount even though you just dehydrated.",{"_29":17956,"_31":17957},[],{"_33":2680,"_35":17958,"_37":2430,"_39":17959,"_63":17960,"_65":17965,"_67":66},"g49pUXsZ",{},[17961],{"_33":2751,"_2788":17962,"_2790":17963,"_39":17964,"_67":66},[649],[2965],{},"Using /actions for mutations while RQ also invalidates → dueling revalidations.",{"_33":3020,"_35":17967,"_37":2430,"_39":17968,"_63":17969,"_65":17970,"_67":66},"-NWQYQuX",{"_2719":2972},[],"Common faceplants",{"_29":17972,"_31":17973},[],{"_33":3020,"_35":17974,"_37":2430,"_39":17975,"_63":17976,"_65":17977,"_67":66},"IZrt37t8",{},[],"Why RQ wins post-hydrate",{"_29":17979,"_31":17980},[],{"_33":2680,"_35":17981,"_37":2430,"_39":17982,"_63":17983,"_65":17984,"_67":66},"uMtIoyeg",{},[],"Remix gives you server data and routing. RQ gives you cache, retries, dedupe, mutations, optimistic UI, background refresh. After first paint, you want RQ in charge—or you’re herding cats.",{"_29":17986,"_31":18039},[17987,18002,18013,18024],{"_29":17988,"_31":17989},[],{"_33":2680,"_35":17990,"_37":2430,"_39":17991,"_63":17992,"_65":18001,"_67":66},"STXiHWaS",{},[17993,17997],{"_33":3084,"_2788":17994,"_2790":17995,"_39":17996,"_67":66},[144],[8172],{},{"_33":2751,"_2788":17998,"_2790":17999,"_39":18000,"_67":66},[2817,8236],[6382,7710],{},"RQ-first (recommended)\nDehydrate in loader, read with useQuery only, mutations via RQ, shouldRevalidate=false. Clean, predictable.",{"_29":18003,"_31":18004},[],{"_33":2680,"_35":18005,"_37":2430,"_39":18006,"_63":18007,"_65":18012,"_67":66},"OV7THMOV",{},[18008],{"_33":3084,"_2788":18009,"_2790":18010,"_39":18011,"_67":66},[144],[2965],{},"Remix-first\nUse loaders/fetchers for reads/mutations; drop RQ for that domain. Less power, fewer moving parts.",{"_29":18014,"_31":18015},[],{"_33":2680,"_35":18016,"_37":2430,"_39":18017,"_63":18018,"_65":18023,"_67":66},"bBAmi6UE",{},[18019],{"_33":3084,"_2788":18020,"_2790":18021,"_39":18022,"_67":66},[144,6804],[912,3086],{},"Islands split\nStable parent via Remix loader; volatile lists/resources via resource routes + RQ. Invalidate only those keys. Minimal blast radius.",{"_29":18025,"_31":18026},[],{"_33":2680,"_35":18027,"_37":2430,"_39":18028,"_63":18029,"_65":18038,"_67":66},"P-XRgWiM",{},[18030,18034],{"_33":3084,"_2788":18031,"_2790":18032,"_39":18033,"_67":66},[144,2837],[2918,6369],{},{"_33":2751,"_2788":18035,"_2790":18036,"_39":18037,"_67":66},[2822,2893],[6568,8321],{},"Hybrid with truce\nKeep both, but on mutation: invalidateQueries() and revalidator.revalidate(). Accept extra fetches and complexity. Your call.",{"_33":3020,"_35":18040,"_37":2430,"_39":18041,"_63":18042,"_65":18043,"_67":66},"IZ-dKjFB",{"_2719":3238},[],"Options (pick one, don’t waffle)",[72],"/tech-talks/remix-react-query-why-your-data-looks-drunk",{"_84":2450},{},{"_90":2430,"_94":2448},{"_35":2427,"_102":51,"_52":18050,"_68":2430,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2429],1779255260485,[156,2427,2430,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/remix-react-query-why-your-data-looks-drunk\",\"bafy2bzacec6j5fjl66wu3weplmaaittfxent2dpcndi3tcvbzqblimorxqqh2\",true]",{"_117":18055,"_154":19056,"_157":19057},{"_119":18056,"_139":42,"_140":19055,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":18057,"_35":19053},{"_26":18058,"_68":2456,"_69":51,"_70":19047,"_52":19048,"_78":2465,"_80":19049,"_82":19050,"_88":19051,"_90":2466,"_92":19052,"_96":97},[18059,18066,18106,18170,18282,18307,18511,18587,18665,18714,18794,18875,18954,19005],{"_29":18060,"_31":18061},[],{"_33":2680,"_35":18062,"_37":2466,"_39":18063,"_63":18064,"_65":18065,"_67":66},"2AQxEzt2",{},[],"Text fragment rendering displays specific portions of document text (defined by character ranges) with all inline embeds resolved to their actual content.",{"_29":18067,"_31":18100},[18068],{"_29":18069,"_31":18091},[18070,18077,18084],{"_29":18071,"_31":18072},[],{"_33":2680,"_35":18073,"_37":2466,"_39":18074,"_63":18075,"_65":18076,"_67":66},"7Sfbdmy3",{},[],"Extract characters 10-50 from the block's text",{"_29":18078,"_31":18079},[],{"_33":2680,"_35":18080,"_37":2466,"_39":18081,"_63":18082,"_65":18083,"_67":66},"pU9EmXDA",{},[],"Resolve any inline embeds within that range",{"_29":18085,"_31":18086},[],{"_33":2680,"_35":18087,"_37":2466,"_39":18088,"_63":18089,"_65":18090,"_67":66},"pTd7tWCx",{},[],"Display the resulting text with embed names",{"_33":2680,"_35":18092,"_37":2466,"_39":18093,"_63":18094,"_65":18099,"_67":66},"p4bS3k9R",{"_2719":3238},[18095],{"_33":2751,"_2788":18096,"_2790":18097,"_39":18098,"_67":66},[2853],[8306],{},"When embedding a document fragment with a range (e.g., hm://account/doc#blockId[10:50]), the system needs to:",{"_33":3020,"_35":18101,"_37":18102,"_39":18103,"_63":18104,"_65":18105,"_67":66},"G0HJUcvf","bafy2bzacecoypfxa5xumes5igxbeqsxvrrfzadhvxj3o2o5dd5eegalwen6ow",{"_2719":243},[],"Overview",{"_29":18107,"_31":18165},[18108,18144],{"_29":18109,"_31":18135},[18110,18117,18128],{"_29":18111,"_31":18112},[],{"_33":2680,"_35":18113,"_37":2466,"_39":18114,"_63":18115,"_65":18116,"_67":66},"ID_nVwnC",{},[],"Counts actual text characters",{"_29":18118,"_31":18119},[],{"_33":2680,"_35":18120,"_37":2466,"_39":18121,"_63":18122,"_65":18127,"_67":66},"Zte1v8Xz",{},[18123],{"_33":3084,"_2788":18124,"_2790":18125,"_39":18126,"_67":66},[144],[1057],{},"Excludes invisible inline embed markers (U+FEFF)",{"_29":18129,"_31":18130},[],{"_33":2680,"_35":18131,"_37":2466,"_39":18132,"_63":18133,"_65":18134,"_67":66},"Lhmt73y1",{},[],"Uses unicode code points (not UTF-16 code units)",{"_33":2680,"_35":18136,"_37":2466,"_39":18137,"_63":18138,"_65":18143,"_67":66},"okSe950P",{"_2719":2972},[18139],{"_33":3084,"_2788":18140,"_2790":18141,"_39":18142,"_67":66},[6386],[8080],{},"Fragment ranges are specified using unicode code point positions in the original text, which:",{"_29":18145,"_31":18160},[18146,18153],{"_29":18147,"_31":18148},[],{"_33":2680,"_35":18149,"_37":2466,"_39":18150,"_63":18151,"_65":18152,"_67":66},"2N4petb7",{},[],"Inline embeds are replaced with document names",{"_29":18154,"_31":18155},[],{"_33":2680,"_35":18156,"_37":2466,"_39":18157,"_63":18158,"_65":18159,"_67":66},"Yj-V3U9C",{},[],"Character positions map correctly to the original range",{"_33":2680,"_35":18161,"_37":2466,"_39":18162,"_63":18163,"_65":18164,"_67":66},"CTKzdWnQ",{"_2719":2972},[],"But we want to display text where:",{"_33":3020,"_35":18166,"_37":18102,"_39":18167,"_63":18168,"_65":18169,"_67":66},"LwEpNjAZ",{"_2719":243},[],"The Challenge",{"_29":18171,"_31":18277},[18172,18190],{"_29":18173,"_31":18185},[18174],{"_29":18175,"_31":18176},[],{"_33":2680,"_35":18177,"_37":2466,"_39":18178,"_63":18179,"_65":18184,"_67":66},"sPGkongJ",{},[18180],{"_33":2751,"_2788":18181,"_2790":18182,"_39":18183,"_67":66},[144],[754],{},"frontend/packages/ui/src/document-content.tsx",{"_33":3020,"_35":18186,"_37":18102,"_39":18187,"_63":18188,"_65":18189,"_67":66},"V2oxMfcS",{"_2719":243},[],"Component Location",{"_29":18191,"_31":18272},[18192,18199],{"_29":18193,"_31":18194},[],{"_33":2751,"_35":18195,"_37":2466,"_39":18196,"_63":18197,"_65":18198,"_67":66},"PD6OxYD_",{"_2753":13245},[],"function FragmentText({\n documentId,\n blockRef,\n start,\n end,\n}: {\n documentId: UnpackedHypermediaId\n blockRef: string\n start: number\n end: number\n})\n",{"_29":18200,"_31":18263},[18201,18223,18245],{"_29":18202,"_31":18210},[18203],{"_29":18204,"_31":18205},[],{"_33":2751,"_35":18206,"_37":2466,"_39":18207,"_63":18208,"_65":18209,"_67":66},"WXIBSnsF",{"_2753":13245},[],"getDocumentText(\n {...documentId, blockRef, blockRange: null},\n {lineBreaks: false, resolveInlineEmbeds: true}\n)\n",{"_33":2680,"_35":18211,"_37":2466,"_39":18212,"_63":18213,"_65":18222,"_67":66},"g_xug3Tw",{"_2719":243},[18214,18218],{"_33":3084,"_2788":18215,"_2790":18216,"_39":18217,"_67":66},[144],[2087],{},{"_33":2751,"_2788":18219,"_2790":18220,"_39":18221,"_67":66},[2836,2851],[439,8080],{},"Fetch Full Text: Call getDocumentText with the blockRef and resolveInlineEmbeds: true",{"_29":18224,"_31":18232},[18225],{"_29":18226,"_31":18227},[],{"_33":2751,"_35":18228,"_37":2466,"_39":18229,"_63":18230,"_65":18231,"_67":66},"pU3qHOXg",{"_2753":13245},[],"const codePoints = Array.from(fullText)\nconst fragment = codePoints.slice(start, end).join('')\n",{"_33":2680,"_35":18233,"_37":2466,"_39":18234,"_63":18235,"_65":18244,"_67":66},"wVk_knmG",{"_2719":243},[18236,18240],{"_33":3084,"_2788":18237,"_2790":18238,"_39":18239,"_67":66},[144],[1182],{},{"_33":2751,"_2788":18241,"_2790":18242,"_39":18243,"_67":66},[2836],[2792],{},"Extract Fragment: Use Array.from() to properly handle unicode code points",{"_29":18246,"_31":18254},[18247],{"_29":18248,"_31":18249},[],{"_33":2751,"_35":18250,"_37":2466,"_39":18251,"_63":18252,"_65":18253,"_67":66},"iWcIY3M_",{"_2753":13245},[],"{fragment}\n",{"_33":2680,"_35":18255,"_37":2466,"_39":18256,"_63":18257,"_65":18262,"_67":66},"z207SaG1",{"_2719":243},[18258],{"_33":3084,"_2788":18259,"_2790":18260,"_39":18261,"_67":66},[144],[882],{},"Display: Render the extracted text",{"_33":2680,"_35":18264,"_37":2466,"_39":18265,"_63":18266,"_65":18271,"_67":66},"im6tjwrr",{"_2719":3238},[18267],{"_33":3084,"_2788":18268,"_2790":18269,"_39":18270,"_67":66},[144],[1057],{},"Process:",{"_33":3020,"_35":18273,"_37":18102,"_39":18274,"_63":18275,"_65":18276,"_67":66},"63mv-pMB",{"_2719":243},[],"How It Works",{"_33":3020,"_35":18278,"_37":18102,"_39":18279,"_63":18280,"_65":18281,"_67":66},"7zjcmUp5",{"_2719":243},[],"Solution: FragmentText Component",{"_29":18283,"_31":18302},[18284,18295],{"_29":18285,"_31":18286},[],{"_33":2680,"_35":18287,"_37":2466,"_39":18288,"_63":18289,"_65":18294,"_67":66},"ckffVPlq",{},[18290],{"_33":2751,"_2788":18291,"_2790":18292,"_39":18293,"_67":66},[1835],[1182],{},"The ContentEmbed component detects text fragments and renders them appropriately:",{"_29":18296,"_31":18297},[],{"_33":2751,"_35":18298,"_37":2466,"_39":18299,"_63":18300,"_65":18301,"_67":66},"qvKjS-q1",{"_2753":13245},[],"// Check if this is a text fragment (blockRef with start/end range)\nconst isTextFragment =\n props.blockRef &&\n props.blockRange &&\n 'start' in props.blockRange &&\n 'end' in props.blockRange\n\nif (isTextFragment && props.blockRef && props.blockRange &&\n 'start' in props.blockRange && 'end' in props.blockRange) {\n // Render as plain text with resolved embeds\n content = (\n \n )\n} else {\n // Normal block rendering\n // ...\n}\n",{"_33":3020,"_35":18303,"_37":18102,"_39":18304,"_63":18305,"_65":18306,"_67":66},"JEAUgjgt",{"_2719":243},[],"Integration with ContentEmbed",{"_29":18308,"_31":18506},[18309,18364,18437],{"_29":18310,"_31":18359},[18311,18322,18329,18344],{"_29":18312,"_31":18313},[],{"_33":2680,"_35":18314,"_37":2466,"_39":18315,"_63":18316,"_65":18321,"_67":66},"YCqkIZTx",{},[18317],{"_33":3084,"_2788":18318,"_2790":18319,"_39":18320,"_67":66},[144],[2551],{},"Original block text:",{"_29":18323,"_31":18324},[],{"_33":2751,"_35":18325,"_37":2466,"_39":18326,"_63":18327,"_65":18328,"_67":66},"1hskuso6",{"_2753":66},[],"\"Hello world, this is a test paragraph with some content.\"\n",{"_29":18330,"_31":18331},[],{"_33":2680,"_35":18332,"_37":2466,"_39":18333,"_63":18334,"_65":18343,"_67":66},"o6BezkUf",{},[18335,18339],{"_33":3084,"_2788":18336,"_2790":18337,"_39":18338,"_67":66},[144],[1057],{},{"_33":2751,"_2788":18340,"_2790":18341,"_39":18342,"_67":66},[7514],[1330],{},"Fragment: #blockId[0:11]",{"_29":18345,"_31":18346},[],{"_33":2680,"_35":18347,"_37":2466,"_39":18348,"_63":18349,"_65":18358,"_67":66},"BMzIlh8L",{},[18350,18354],{"_33":3084,"_2788":18351,"_2790":18352,"_39":18353,"_67":66},[144],[649],{},{"_33":2751,"_2788":18355,"_2790":18356,"_39":18357,"_67":66},[1057],[2907],{},"Result: \"Hello world\"",{"_33":3020,"_35":18360,"_37":18102,"_39":18361,"_63":18362,"_65":18363,"_67":66},"iDz8Q6OO",{"_2719":243},[],"Example 1: Simple Text Fragment",{"_29":18365,"_31":18432},[18366,18377,18384,18395,18402,18417],{"_29":18367,"_31":18368},[],{"_33":2680,"_35":18369,"_37":2466,"_39":18370,"_63":18371,"_65":18376,"_67":66},"9S6ZH_mk",{},[18372],{"_33":3084,"_2788":18373,"_2790":18374,"_39":18375,"_67":66},[144],[754],{},"Original block text (with invisible markers):",{"_29":18378,"_31":18379},[],{"_33":2751,"_35":18380,"_37":2466,"_39":18381,"_63":18382,"_65":18383,"_67":66},"7zNe8eXa",{"_2753":66},[],"\"Check out \\uFEFF post about AI!\"\n// Position: 0-9, [10 = embed], 11-25\n",{"_29":18385,"_31":18386},[],{"_33":2680,"_35":18387,"_37":2466,"_39":18388,"_63":18389,"_65":18394,"_67":66},"aURuOQn2",{},[18390],{"_33":3084,"_2788":18391,"_2790":18392,"_39":18393,"_67":66},[144],[6286],{},"With inline embed resolved:",{"_29":18396,"_31":18397},[],{"_33":2751,"_35":18398,"_37":2466,"_39":18399,"_63":18400,"_65":18401,"_67":66},"2J1ilyYt",{"_2753":66},[],"\"Check out @Alice's Guide post about AI!\"\n",{"_29":18403,"_31":18404},[],{"_33":2680,"_35":18405,"_37":2466,"_39":18406,"_63":18407,"_65":18416,"_67":66},"kaO539LI",{},[18408,18412],{"_33":3084,"_2788":18409,"_2790":18410,"_39":18411,"_67":66},[144],[1057],{},{"_33":2751,"_2788":18413,"_2790":18414,"_39":18415,"_67":66},[7514],[1330],{},"Fragment: #blockId[0:20]",{"_29":18418,"_31":18419},[],{"_33":2680,"_35":18420,"_37":2466,"_39":18421,"_63":18422,"_65":18431,"_67":66},"Zr55I9qf",{},[18423,18427],{"_33":3084,"_2788":18424,"_2790":18425,"_39":18426,"_67":66},[144],[649],{},{"_33":2751,"_2788":18428,"_2790":18429,"_39":18430,"_67":66},[1057],[6837],{},"Result: \"Check out @Alice's Guide pos\" (first 20 unicode code points)",{"_33":3020,"_35":18433,"_37":18102,"_39":18434,"_63":18435,"_65":18436,"_67":66},"a5fPxHJY",{"_2719":243},[],"Example 2: Fragment with Inline Embed",{"_29":18438,"_31":18501},[18439,18450,18457,18468,18475,18490],{"_29":18440,"_31":18441},[],{"_33":2680,"_35":18442,"_37":2466,"_39":18443,"_63":18444,"_65":18449,"_67":66},"dk1c5DlJ",{},[18445],{"_33":3084,"_2788":18446,"_2790":18447,"_39":18448,"_67":66},[144],[912],{},"Original text:",{"_29":18451,"_31":18452},[],{"_33":2751,"_35":18453,"_37":2466,"_39":18454,"_63":18455,"_65":18456,"_67":66},"oTceVd84",{"_2753":66},[],"\"Read \\uFEFF and \\uFEFF for more info\"\n// [Read ][embed1][ and ][embed2][ for more info]\n",{"_29":18458,"_31":18459},[],{"_33":2680,"_35":18460,"_37":2466,"_39":18461,"_63":18462,"_65":18467,"_67":66},"_OH0sp5H",{},[18463],{"_33":3084,"_2788":18464,"_2790":18465,"_39":18466,"_67":66},[144],[2907],{},"With embeds resolved:",{"_29":18469,"_31":18470},[],{"_33":2751,"_35":18471,"_37":2466,"_39":18472,"_63":18473,"_65":18474,"_67":66},"gNCFEUnh",{"_2753":66},[],"\"Read @Getting Started and @Advanced Topics for more info\"\n",{"_29":18476,"_31":18477},[],{"_33":2680,"_35":18478,"_37":2466,"_39":18479,"_63":18480,"_65":18489,"_67":66},"cCggRTwW",{},[18481,18485],{"_33":3084,"_2788":18482,"_2790":18483,"_39":18484,"_67":66},[144],[1057],{},{"_33":2751,"_2788":18486,"_2790":18487,"_39":18488,"_67":66},[7514],[1330],{},"Fragment: #blockId[0:25]",{"_29":18491,"_31":18492},[],{"_33":2680,"_35":18493,"_37":2466,"_39":18494,"_63":18495,"_65":18500,"_67":66},"yBQMmBNe",{},[18496],{"_33":3084,"_2788":18497,"_2790":18498,"_39":18499,"_67":66},[144],[649],{},"Result: First 25 code points with both embed names included",{"_33":3020,"_35":18502,"_37":18102,"_39":18503,"_63":18504,"_65":18505,"_67":66},"NI2C9wms",{"_2719":243},[],"Example 3: Multiple Inline Embeds",{"_33":3020,"_35":18507,"_37":18102,"_39":18508,"_63":18509,"_65":18510,"_67":66},"sRnlocyj",{"_2719":243},[],"Example Scenarios",{"_29":18512,"_31":18582},[18513,18561],{"_29":18514,"_31":18556},[18515,18526,18541],{"_29":18516,"_31":18517},[],{"_33":2680,"_35":18518,"_37":2466,"_39":18519,"_63":18520,"_65":18525,"_67":66},"c0oJqPcs",{},[18521],{"_33":3084,"_2788":18522,"_2790":18523,"_39":18524,"_67":66},[144],[2918],{},"Original Positions: Defined in the blockRange, count actual text excluding embed markers",{"_29":18527,"_31":18528},[],{"_33":2680,"_35":18529,"_37":2466,"_39":18530,"_63":18531,"_65":18540,"_67":66},"OF0qe0zF",{},[18532,18536],{"_33":3084,"_2788":18533,"_2790":18534,"_39":18535,"_67":66},[144],[2805],{},{"_33":2751,"_2788":18537,"_2790":18538,"_39":18539,"_67":66},[2907],[6571],{},"Resolved Text: After documentToText processes it, embeds become their document names",{"_29":18542,"_31":18543},[],{"_33":2680,"_35":18544,"_37":2466,"_39":18545,"_63":18546,"_65":18555,"_67":66},"-4ijt-qu",{},[18547,18551],{"_33":3084,"_2788":18548,"_2790":18549,"_39":18550,"_67":66},[144],[2839],{},{"_33":2751,"_2788":18552,"_2790":18553,"_39":18554,"_67":66},[3926],[439],{},"Unicode Code Points: Use Array.from() to properly count multi-byte characters",{"_33":3020,"_35":18557,"_37":2466,"_39":18558,"_63":18559,"_65":18560,"_67":66},"09rTCjd6",{"_2719":3238},[],"Key Concepts",{"_29":18562,"_31":18577},[18563,18570],{"_29":18564,"_31":18565},[],{"_33":2680,"_35":18566,"_37":2466,"_39":18567,"_63":18568,"_65":18569,"_67":66},"NZv8UlOi",{},[],"JavaScript strings are UTF-16 encoded. Emojis and special characters may use multiple UTF-16 code units:",{"_29":18571,"_31":18572},[],{"_33":2751,"_35":18573,"_37":2466,"_39":18574,"_63":18575,"_65":18576,"_67":66},"ivBOxmnW",{"_2753":13245},[],"// Wrong: UTF-16 code units\n\"Hello 👋\".length // 7 (emoji uses 2 code units)\n\n// Correct: Unicode code points\nArray.from(\"Hello 👋\").length // 6 (emoji is 1 code point)\n",{"_33":3020,"_35":18578,"_37":18102,"_39":18579,"_63":18580,"_65":18581,"_67":66},"RnfUWiwR",{"_2719":243},[],"Why Array.from()?",{"_33":3020,"_35":18583,"_37":18102,"_39":18584,"_63":18585,"_65":18586,"_67":66},"gsg9HI2J",{"_2719":243},[],"Character Position Mapping",{"_29":18588,"_31":18660},[18589,18596,18628],{"_29":18590,"_31":18591},[],{"_33":2680,"_35":18592,"_37":2466,"_39":18593,"_63":18594,"_65":18595,"_67":66},"9Afg8sIB",{},[],"Fragment rendering works seamlessly in both desktop and web:",{"_29":18597,"_31":18623},[18598,18609,18616],{"_29":18599,"_31":18600},[],{"_33":2680,"_35":18601,"_37":2466,"_39":18602,"_63":18603,"_65":18608,"_67":66},"mOIYkNDb",{},[18604],{"_33":2751,"_2788":18605,"_2790":18606,"_39":18607,"_67":66},[882],[2821],{},"Direct grpcClient access",{"_29":18610,"_31":18611},[],{"_33":2680,"_35":18612,"_37":2466,"_39":18613,"_63":18614,"_65":18615,"_67":66},"AilfdYeZ",{},[],"Synchronous document fetching",{"_29":18617,"_31":18618},[],{"_33":2680,"_35":18619,"_37":2466,"_39":18620,"_63":18621,"_65":18622,"_67":66},"tyPDwr0h",{},[],"Immediate text resolution",{"_33":3020,"_35":18624,"_37":2466,"_39":18625,"_63":18626,"_65":18627,"_67":66},"jMn41UV1",{"_2719":2972},[],"Desktop",{"_29":18629,"_31":18655},[18630,18641,18648],{"_29":18631,"_31":18632},[],{"_33":2680,"_35":18633,"_37":2466,"_39":18634,"_63":18635,"_65":18640,"_67":66},"nC1TkfZp",{},[18636],{"_33":2751,"_2788":18637,"_2790":18638,"_39":18639,"_67":66},[2821],[6837],{},"Server-side API: /hm/api/document-text",{"_29":18642,"_31":18643},[],{"_33":2680,"_35":18644,"_37":2466,"_39":18645,"_63":18646,"_65":18647,"_67":66},"xr_sMT22",{},[],"Accepts blockRef in URL parameters",{"_29":18649,"_31":18650},[],{"_33":2680,"_35":18651,"_37":2466,"_39":18652,"_63":18653,"_65":18654,"_67":66},"sAkzpS7s",{},[],"Returns resolved text via JSON",{"_33":3020,"_35":18656,"_37":2466,"_39":18657,"_63":18658,"_65":18659,"_67":66},"QPLTiQqh",{"_2719":2972},[],"Web",{"_33":3020,"_35":18661,"_37":18102,"_39":18662,"_63":18663,"_65":18664,"_67":66},"w9r8e0e-",{"_2719":243},[],"API Endpoint Support",{"_29":18666,"_31":18709},[18667,18681,18695],{"_29":18668,"_31":18676},[18669],{"_29":18670,"_31":18671},[],{"_33":2751,"_35":18672,"_37":2466,"_39":18673,"_63":18674,"_65":18675,"_67":66},"VvCaHE4p",{"_2753":13245},[],"if (loading) {\n return (\n \n \n \n )\n}\n",{"_33":3020,"_35":18677,"_37":18102,"_39":18678,"_63":18679,"_65":18680,"_67":66},"wI01-Han",{"_2719":243},[],"Loading",{"_29":18682,"_31":18690},[18683],{"_29":18684,"_31":18685},[],{"_33":2751,"_35":18686,"_37":2466,"_39":18687,"_63":18688,"_65":18689,"_67":66},"8EJtU0zB",{"_2753":13245},[],"if (error) {\n return \n}\n",{"_33":3020,"_35":18691,"_37":18102,"_39":18692,"_63":18693,"_65":18694,"_67":66},"ew5oXSYq",{"_2719":243},[],"Error",{"_29":18696,"_31":18704},[18697],{"_29":18698,"_31":18699},[],{"_33":2751,"_35":18700,"_37":2466,"_39":18701,"_63":18702,"_65":18703,"_67":66},"8Yj_wH_F",{"_2753":13245},[],"return (\n \n {text}\n \n)\n",{"_33":3020,"_35":18705,"_37":18102,"_39":18706,"_63":18707,"_65":18708,"_67":66},"8IuxlY98",{"_2719":243},[],"Success",{"_33":3020,"_35":18710,"_37":18102,"_39":18711,"_63":18712,"_65":18713,"_67":66},"oqtJOgPb",{"_2719":243},[],"Component States",{"_29":18715,"_31":18789},[18716],{"_29":18717,"_31":18784},[18718,18729,18744],{"_29":18719,"_31":18720},[],{"_33":2680,"_35":18721,"_37":2466,"_39":18722,"_63":18723,"_65":18728,"_67":66},"hrkmNvEU",{},[18724],{"_33":3084,"_2788":18725,"_2790":18726,"_39":18727,"_67":66},[144],[649],{},"Editor: User selects text range in a block",{"_29":18730,"_31":18731},[],{"_33":2680,"_35":18732,"_37":2466,"_39":18733,"_63":18734,"_65":18743,"_67":66},"KF1l79hD",{},[18735,18739],{"_33":3084,"_2788":18736,"_2790":18737,"_39":18738,"_67":66},[144],[2805],{},{"_33":2751,"_2788":18740,"_2790":18741,"_39":18742,"_67":66},[6567],[6790],{},"Link Creation: System creates link like hm://account/doc#blockId[10:50]",{"_29":18745,"_31":18775},[18746,18757,18768],{"_29":18747,"_31":18748},[],{"_33":2680,"_35":18749,"_37":2466,"_39":18750,"_63":18751,"_65":18756,"_67":66},"VQmz8yke",{},[18752],{"_33":2751,"_2788":18753,"_2790":18754,"_39":18755,"_67":66},[144],[2965],{},"ContentEmbed detects the range",{"_29":18758,"_31":18759},[],{"_33":2680,"_35":18760,"_37":2466,"_39":18761,"_63":18762,"_65":18767,"_67":66},"eBiiW6iw",{},[18763],{"_33":2751,"_2788":18764,"_2790":18765,"_39":18766,"_67":66},[144],[2965],{},"FragmentText fetches and extracts text",{"_29":18769,"_31":18770},[],{"_33":2680,"_35":18771,"_37":2466,"_39":18772,"_63":18773,"_65":18774,"_67":66},"eGZ7xnSR",{},[],"Displays resolved fragment",{"_33":2680,"_35":18776,"_37":2466,"_39":18777,"_63":18778,"_65":18783,"_67":66},"MyM8caFB",{"_2719":2972},[18779],{"_33":3084,"_2788":18780,"_2790":18781,"_39":18782,"_67":66},[144],[2905],{},"Rendering:",{"_33":2680,"_35":18785,"_37":2466,"_39":18786,"_63":18787,"_65":18788,"_67":66},"SOdRhrBN",{"_2719":3238},[],"When a user creates an embed with a text range:",{"_33":3020,"_35":18790,"_37":18102,"_39":18791,"_63":18792,"_65":18793,"_67":66},"wRi7E2mW",{"_2719":243},[],"Usage in Embeds",{"_29":18795,"_31":18870},[18796,18828,18856],{"_29":18797,"_31":18823},[18798,18809,18816],{"_29":18799,"_31":18800},[],{"_33":2680,"_35":18801,"_37":2466,"_39":18802,"_63":18803,"_65":18808,"_67":66},"St53QBel",{},[18804],{"_33":2751,"_2788":18805,"_2790":18806,"_39":18807,"_67":66},[2821],[2866],{},"Consider caching getDocumentText results",{"_29":18810,"_31":18811},[],{"_33":2680,"_35":18812,"_37":2466,"_39":18813,"_63":18814,"_65":18815,"_67":66},"chKSyATF",{},[],"Fragment extraction is fast (O(n) where n = text length)",{"_29":18817,"_31":18818},[],{"_33":2680,"_35":18819,"_37":2466,"_39":18820,"_63":18821,"_65":18822,"_67":66},"QDysylVq",{},[],"Network requests may be slow on web",{"_33":3020,"_35":18824,"_37":2466,"_39":18825,"_63":18826,"_65":18827,"_67":66},"20FIkrPQ",{"_2719":2972},[],"Caching",{"_29":18829,"_31":18851},[18830,18837,18844],{"_29":18831,"_31":18832},[],{"_33":2680,"_35":18833,"_37":2466,"_39":18834,"_63":18835,"_65":18836,"_67":66},"pb4xKmmy",{},[],"Only fetch when fragment changes",{"_29":18838,"_31":18839},[],{"_33":2680,"_35":18840,"_37":2466,"_39":18841,"_63":18842,"_65":18843,"_67":66},"Nhoihj4_",{},[],"UseEffect dependencies include all ID components",{"_29":18845,"_31":18846},[],{"_33":2680,"_35":18847,"_37":2466,"_39":18848,"_63":18849,"_65":18850,"_67":66},"yCXUAt11",{},[],"Loading state prevents UI jank",{"_33":3020,"_35":18852,"_37":2466,"_39":18853,"_63":18854,"_65":18855,"_67":66},"Y7JF9krF",{"_2719":2972},[],"Optimization",{"_29":18857,"_31":18865},[18858],{"_29":18859,"_31":18860},[],{"_33":2751,"_35":18861,"_37":2466,"_39":18862,"_63":18863,"_65":18864,"_67":66},"HNtX3FKP",{"_2753":13245},[],"useEffect(() => {\n // ...\n}, [\n getDocumentText,\n documentId.uid,\n documentId.path?.join('/'),\n documentId.version,\n blockRef,\n start,\n end\n])\n",{"_33":3020,"_35":18866,"_37":18102,"_39":18867,"_63":18868,"_65":18869,"_67":66},"WeyIFqay",{"_2719":243},[],"Dependencies",{"_33":3020,"_35":18871,"_37":18102,"_39":18872,"_63":18873,"_65":18874,"_67":66},"kYLADXMg",{"_2719":243},[],"Performance Considerations",{"_29":18876,"_31":18950},[18877],{"_29":18878,"_31":18945},[18879,18890,18901,18912,18923,18934],{"_29":18880,"_31":18881},[],{"_33":2680,"_35":18882,"_37":2466,"_39":18883,"_63":18884,"_65":18889,"_67":66},"3vc5z7_P",{},[18885],{"_33":3084,"_2788":18886,"_2790":18887,"_39":18888,"_67":66},[144],[3926],{},"Basic fragment extraction: Simple text without embeds",{"_29":18891,"_31":18892},[],{"_33":2680,"_35":18893,"_37":2466,"_39":18894,"_63":18895,"_65":18900,"_67":66},"ijDLC0ov",{},[18896],{"_33":3084,"_2788":18897,"_2790":18898,"_39":18899,"_67":66},[144],[2839],{},"Single inline embed: Fragment includes embed name",{"_29":18902,"_31":18903},[],{"_33":2680,"_35":18904,"_37":2466,"_39":18905,"_63":18906,"_65":18911,"_67":66},"lRc9Gfdv",{},[18907],{"_33":3084,"_2788":18908,"_2790":18909,"_39":18910,"_67":66},[144],[2836],{},"Multiple inline embeds: All embeds resolved correctly",{"_29":18913,"_31":18914},[],{"_33":2680,"_35":18915,"_37":2466,"_39":18916,"_63":18917,"_65":18922,"_67":66},"d-_byl6F",{},[18918],{"_33":3084,"_2788":18919,"_2790":18920,"_39":18921,"_67":66},[144],[1182],{},"Unicode handling: Emojis and special characters",{"_29":18924,"_31":18925},[],{"_33":2680,"_35":18926,"_37":2466,"_39":18927,"_63":18928,"_65":18933,"_67":66},"tlIcCaYP",{},[18929],{"_33":3084,"_2788":18930,"_2790":18931,"_39":18932,"_67":66},[144],[912],{},"Boundary cases: start=0, end=text.length",{"_29":18935,"_31":18936},[],{"_33":2680,"_35":18937,"_37":2466,"_39":18938,"_63":18939,"_65":18944,"_67":66},"-9wfpL5z",{},[18940],{"_33":3084,"_2788":18941,"_2790":18942,"_39":18943,"_67":66},[144],[912],{},"Error handling: Missing blocks, network errors",{"_33":2680,"_35":18946,"_37":2466,"_39":18947,"_63":18948,"_65":18949,"_67":66},"UldeaHf_",{"_2719":3238},[],"Test scenarios to verify:",{"_33":3020,"_35":18951,"_37":18102,"_39":18952,"_63":18953,"_65":14441,"_67":66},"zZsnUvpO",{"_2719":243},[],{"_29":18955,"_31":19000},[18956,18967,18978,18989],{"_29":18957,"_31":18958},[],{"_33":2680,"_35":18959,"_37":2466,"_39":18960,"_63":18961,"_65":18966,"_67":66},"4cxhkyzz",{},[18962],{"_33":2751,"_2788":18963,"_2790":18964,"_39":18965,"_67":66},[144],[754],{},"frontend/packages/ui/src/document-content.tsx - FragmentText component",{"_29":18968,"_31":18969},[],{"_33":2680,"_35":18970,"_37":2466,"_39":18971,"_63":18972,"_65":18977,"_67":66},"gl7dYRlG",{},[18973],{"_33":2751,"_2788":18974,"_2790":18975,"_39":18976,"_67":66},[144],[6365],{},"frontend/packages/shared/src/document-to-text.ts - Text resolution",{"_29":18979,"_31":18980},[],{"_33":2680,"_35":18981,"_37":2466,"_39":18982,"_63":18983,"_65":18988,"_67":66},"_H22v0RU",{},[18984],{"_33":2751,"_2788":18985,"_2790":18986,"_39":18987,"_67":66},[144],[2817],{},"frontend/packages/shared/src/document-content-types.ts - Type definitions",{"_29":18990,"_31":18991},[],{"_33":2680,"_35":18992,"_37":2466,"_39":18993,"_63":18994,"_65":18999,"_67":66},"ETnm5hgI",{},[18995],{"_33":2751,"_2788":18996,"_2790":18997,"_39":18998,"_67":66},[144],[6572],{},"frontend/apps/web/app/routes/hm.api.document-text.tsx - Web API",{"_33":3020,"_35":19001,"_37":2466,"_39":19002,"_63":19003,"_65":19004,"_67":66},"gutU_mQb",{"_2719":2972},[],"Related Files",{"_29":19006,"_31":19042},[19007,19018,19030],{"_29":19008,"_31":19009},[],{"_33":2680,"_35":19010,"_37":2456,"_39":19011,"_63":19012,"_65":2540,"_67":66},"pXje3YS5",{},[19013],{"_33":204,"_2788":19014,"_2790":19015,"_39":19016,"_67":19017},[144],[3926],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-to-text-function?v=bafy2bzacecdcvfpp3eagebhnu4eolfvyon2pfvp2ykl4qnidggatkabnsumem&l",{"_29":19019,"_31":19020},[],{"_33":2680,"_35":19021,"_37":2456,"_39":19022,"_63":19023,"_65":19029,"_67":66},"5tQqsyUo",{},[19024],{"_33":204,"_2788":19025,"_2790":19026,"_39":19027,"_67":19028},[144],[1182],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/linking?v=bafy2bzacedtevim3q4ybtoohumxjpvniscrxbpvd3hscofjobyls2c5djysug&l","Document Linking",{"_29":19031,"_31":19032},[],{"_33":2680,"_35":19033,"_37":2456,"_39":19034,"_63":19035,"_65":19041,"_67":66},"fhWZxoA7",{},[19036],{"_33":204,"_2788":19037,"_2790":19038,"_39":19039,"_67":19040},[144],[2087],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-block-types?v=bafy2bzaceb424vzlgrj45dfv6kfsb4oaatln62bni2cirlgv5m2wpalye22m6&l","Document Blocks",{"_33":3020,"_35":19043,"_37":2466,"_39":19044,"_63":19045,"_65":19046,"_67":66},"nKkEq5Vt",{"_2719":2972},[],"Related Documentation",[76],"/tech-talks/text-fragment-rendering","2025-10-24T16:15:06.504Z",{"_84":2475},{},{"_90":2466,"_94":2473},{"_35":2453,"_102":51,"_52":19054,"_68":2456,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2455],1779255260497,[156,2453,2456,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/text-fragment-rendering\",\"bafy2bzaced7d25yqqvto2ouca5cc5oe3kesdp27ow5nwy76gpwh6idflmnwla\",true]",{"_117":19059,"_154":19366,"_157":19367},{"_119":19060,"_139":42,"_140":19365,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":19061,"_35":19363},{"_26":19062,"_68":2481,"_69":51,"_70":19358,"_52":19359,"_78":2487,"_80":2487,"_82":19360,"_88":19361,"_90":2481,"_92":19362,"_96":97},[19063,19074,19081,19128,19171,19215,19314,19335],{"_29":19064,"_31":19065},[],{"_33":2680,"_35":19066,"_37":2481,"_39":19067,"_63":19068,"_65":19073,"_67":66},"XgHevQBb",{},[19069],{"_33":2751,"_2788":19070,"_2790":19071,"_39":19072,"_67":66},[2806],[3243],{},"HyperDocs links, prefixed with hm://, take the following form:",{"_29":19075,"_31":19076},[],{"_33":2751,"_35":19077,"_37":2481,"_39":19078,"_63":19079,"_65":19080,"_67":66},"essbTKio",{"_2753":66},[],"hm://d/DOCUMENT_ID?v=VERSION_REF#BLOCK_REF",{"_29":19082,"_31":19123},[19083],{"_29":19084,"_31":19118},[19085,19096,19107],{"_29":19086,"_31":19087},[],{"_33":2680,"_35":19088,"_37":2481,"_39":19089,"_63":19090,"_65":19095,"_67":66},"Al5NGTyL",{},[19091],{"_33":2751,"_2788":19092,"_2790":19093,"_39":19094,"_67":66},[144],[390],{},"hm:// - the HyperDocs URL scheme",{"_29":19097,"_31":19098},[],{"_33":2680,"_35":19099,"_37":2481,"_39":19100,"_63":19101,"_65":19106,"_67":66},"DEg9l2CZ",{},[19102],{"_33":2751,"_2788":19103,"_2790":19104,"_39":19105,"_67":66},[144],[516],{},"d/ - the Entity Type ID",{"_29":19108,"_31":19109},[],{"_33":2680,"_35":19110,"_37":2481,"_39":19111,"_63":19112,"_65":19117,"_67":66},"pPAOzLB4",{},[19113],{"_33":2751,"_2788":19114,"_2790":19115,"_39":19116,"_67":66},[144],[1300],{},"DOCUMENT_ID - the ID of the Document to reference",{"_33":2680,"_35":19119,"_37":2481,"_39":19120,"_63":19121,"_65":19122,"_67":66},"Zuh31CWJ",{"_2719":2972},[],"The following portion is required:",{"_33":3020,"_35":19124,"_37":2481,"_39":19125,"_63":19126,"_65":19127,"_67":66},"lYVoP4tT",{"_2719":243},[],"Entity References",{"_29":19129,"_31":19166},[19130,19159],{"_29":19131,"_31":19154},[19132,19143],{"_29":19133,"_31":19134},[],{"_33":2680,"_35":19135,"_37":2481,"_39":19136,"_63":19137,"_65":19142,"_67":66},"SGp-lqeB",{},[19138],{"_33":2751,"_2788":19139,"_2790":19140,"_39":19141,"_67":66},[144],[42],{},"d - Document Entity",{"_29":19144,"_31":19145},[],{"_33":2680,"_35":19146,"_37":2481,"_39":19147,"_63":19148,"_65":19153,"_67":66},"j_nyO_3y",{},[19149],{"_33":2751,"_2788":19150,"_2790":19151,"_39":19152,"_67":66},[144],[42],{},"a - Account Entity",{"_33":2680,"_35":19155,"_37":2481,"_39":19156,"_63":19157,"_65":19158,"_67":66},"esGm0USw",{"_2719":2972},[],"The following are valid entity type identifiers",{"_29":19160,"_31":19161},[],{"_33":2680,"_35":19162,"_37":2481,"_39":19163,"_63":19164,"_65":19165,"_67":66},"-GFR2q1q",{},[],"Additional types and conventions are reserved for future use",{"_33":3020,"_35":19167,"_37":2481,"_39":19168,"_63":19169,"_65":19170,"_67":66},"8Y8B5qhJ",{"_2719":243},[],"Entity Type ID",{"_29":19172,"_31":19210},[19173],{"_29":19174,"_31":19197},[19175,19186],{"_29":19176,"_31":19177},[],{"_33":2680,"_35":19178,"_37":2481,"_39":19179,"_63":19180,"_65":19185,"_67":66},"xUphBKab",{},[19181],{"_33":2751,"_2788":19182,"_2790":19183,"_39":19184,"_67":66},[144],[170],{},"?v= - optional query parameter designating the version ref",{"_29":19187,"_31":19188},[],{"_33":2680,"_35":19189,"_37":2481,"_39":19190,"_63":19191,"_65":19196,"_67":66},"Egl-sK97",{},[19192],{"_33":2751,"_2788":19193,"_2790":19194,"_39":19195,"_67":66},[144,7724],[1300,2824],{},"VERSION_REF - the CID(s) of the EntityChange that represent an exact version of the Entity, separated by periods (.)",{"_33":2680,"_35":19198,"_37":2481,"_39":19199,"_63":19200,"_65":19209,"_67":66},"Sl4r_UYU",{"_2719":2972},[19201,19205],{"_33":2751,"_2788":19202,"_2790":19203,"_39":19204,"_67":66},[2821],[6571],{},{"_33":3084,"_2788":19206,"_2790":19207,"_39":19208,"_67":66},[8604],[7717],{},"A link with only hm://d/DOCUMENT_ID is valid, but the entity may change over time. To link to the exact version of an Entity, include:",{"_33":3020,"_35":19211,"_37":2481,"_39":19212,"_63":19213,"_65":19214,"_67":66},"5wtWdXY9",{"_2719":243},[],"Version References",{"_29":19216,"_31":19309},[19217,19229,19258,19269],{"_29":19218,"_31":19219},[],{"_33":2680,"_35":19220,"_37":2481,"_39":19221,"_63":19222,"_65":19228,"_67":66},"KjDaJZo8",{},[19223],{"_33":204,"_2788":19224,"_2790":19225,"_39":19226,"_67":19227},[2821,16752],[2792,7581],{},"./document-entity","When you link to Document Entities, you may deep-link to a specific block (section) of the document heirarchy. These are identified by block ID, as defined by the Document Entity.",{"_29":19230,"_31":19253},[19231,19242],{"_29":19232,"_31":19233},[],{"_33":2680,"_35":19234,"_37":2481,"_39":19235,"_63":19236,"_65":19241,"_67":66},"ynaSMWyY",{},[19237],{"_33":2751,"_2788":19238,"_2790":19239,"_39":19240,"_67":66},[144],[2889],{},"hm://d/DOCUMENT_ID#BLOCK_REF - Block of Entity Ref",{"_29":19243,"_31":19244},[],{"_33":2680,"_35":19245,"_37":2481,"_39":19246,"_63":19247,"_65":19252,"_67":66},"W--n0qXt",{},[19248],{"_33":2751,"_2788":19249,"_2790":19250,"_39":19251,"_67":66},[144],[783],{},"hm://d/DOCUMENT_ID?v=VERSION_REF#BLOCK_REF - Block of Version Ref",{"_33":2680,"_35":19254,"_37":2481,"_39":19255,"_63":19256,"_65":19257,"_67":66},"L-Hogd4w",{"_2719":2972},[],"A block reference points to a specific block within a Entity Reference or a Version Reference.",{"_29":19259,"_31":19260},[],{"_33":2680,"_35":19261,"_37":2481,"_39":19262,"_63":19263,"_65":19268,"_67":66},"yUMyS3wX",{},[19264],{"_33":2751,"_2788":19265,"_2790":19266,"_39":19267,"_67":66},[2905],[2821],{},"A simple BLOCK_ID is a valid Block Ref, but it may also include a character range, pointing to a string within a block. This is a Block Range Ref:",{"_29":19270,"_31":19304},[19271,19282,19293],{"_29":19272,"_31":19273},[],{"_33":2680,"_35":19274,"_37":2481,"_39":19275,"_63":19276,"_65":19281,"_67":66},"L7fIJJqx",{},[19277],{"_33":2751,"_2788":19278,"_2790":19279,"_39":19280,"_67":66},[144],[1057],{},"BLOCK_ID - the block ID of the ref",{"_29":19283,"_31":19284},[],{"_33":2680,"_35":19285,"_37":2481,"_39":19286,"_63":19287,"_65":19292,"_67":66},"jX8WE5Qr",{},[19288],{"_33":2751,"_2788":19289,"_2790":19290,"_39":19291,"_67":66},[144],[390],{},"START - utf8 character point (offset) of the start of the range ref",{"_29":19294,"_31":19295},[],{"_33":2680,"_35":19296,"_37":2481,"_39":19297,"_63":19298,"_65":19303,"_67":66},"SWXPhNzr",{},[19299],{"_33":2751,"_2788":19300,"_2790":19301,"_39":19302,"_67":66},[144],[170],{},"END - utf8 character point (offset) of the start of the range ref",{"_33":2751,"_35":19305,"_37":2481,"_39":19306,"_63":19307,"_65":19308,"_67":66},"XAjjwScg",{"_2719":2972,"_2753":66},[],"BLOCK_ID:START:END\n",{"_33":3020,"_35":19310,"_37":2481,"_39":19311,"_63":19312,"_65":19313,"_67":66},"U8BFqs-C",{"_2719":243},[],"Block References",{"_29":19315,"_31":19330},[19316],{"_29":19317,"_31":19325},[19318],{"_29":19319,"_31":19320},[],{"_33":2680,"_35":19321,"_37":2481,"_39":19322,"_63":19323,"_65":19324,"_67":66},"hSRCJniK",{},[],"TODO",{"_33":2680,"_35":19326,"_37":2481,"_39":19327,"_63":19328,"_65":19329,"_67":66},"kd760cyr",{"_2719":2972},[],"The following are real example links:",{"_33":3020,"_35":19331,"_37":2481,"_39":19332,"_63":19333,"_65":19334,"_67":66},"tZLl3lB5",{"_2719":243},[],"Example Links",{"_29":19336,"_31":19353},[19337],{"_29":19338,"_31":19339},[],{"_33":2680,"_35":19340,"_37":2481,"_39":19341,"_63":19342,"_65":19352,"_67":66},"MvR9FLK5",{},[19343,19348],{"_33":204,"_2788":19344,"_2790":19345,"_39":19346,"_67":19347},[754],[2793],{},"./hyperdocs-aer",{"_33":2751,"_2788":19349,"_2790":19350,"_39":19351,"_67":66},[8080],[3086],{},"Note: The Seed application uses the emerging \"Aer\" protocol to convert HTTPS URLs to hm:// links automatically under the hood",{"_33":3020,"_35":19354,"_37":2481,"_39":19355,"_63":19356,"_65":19357,"_67":66},"-kuoFahd",{"_2719":11996},[],"Web Links",[76],"/tech-talks/linking",{"_84":2496},{},{"_90":2481,"_94":2494},{"_35":2478,"_102":51,"_52":19364,"_68":2481,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2480],1779255260464,[156,2478,2481,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/linking\",\"bafy2bzacedtevim3q4ybtoohumxjpvniscrxbpvd3hscofjobyls2c5djysug\",true]",{"_117":19369,"_154":19560,"_157":19561},{"_119":19370,"_139":42,"_140":19559,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":19371,"_35":19557},{"_26":19372,"_68":2502,"_69":51,"_70":19552,"_52":19553,"_78":2509,"_80":2509,"_82":19554,"_88":19555,"_90":2502,"_92":19556,"_96":97},[19373,19380,19387,19421,19460,19539],{"_29":19374,"_31":19375},[],{"_33":2680,"_35":19376,"_37":2502,"_39":19377,"_63":19378,"_65":19379,"_67":66},"oxYOjr7Z",{},[],"A block is a section of a document. Depending on the type of the block, it may have children.",{"_29":19381,"_31":19382},[],{"_33":3020,"_35":19383,"_37":2502,"_39":19384,"_63":19385,"_65":19386,"_67":66},"hjT7gE9n",{},[],"Text | Video | Image | File",{"_29":19388,"_31":19416},[19389,19396,19402,19409],{"_29":19390,"_31":19391},[],{"_33":2680,"_35":19392,"_37":2502,"_39":19393,"_63":19394,"_65":19395,"_67":66},"e7cmdgpN",{},[],"May have any children blocks",{"_29":19397,"_31":19398},[],{"_33":3020,"_35":19399,"_37":2502,"_39":19400,"_63":19401,"_65":243,"_67":66},"Jh9MJqVg",{},[],{"_29":19403,"_31":19404},[],{"_33":3020,"_35":19405,"_37":2502,"_39":19406,"_63":19407,"_65":19408,"_67":66},"tpltRJ9k",{},[],"OrderedList",{"_29":19410,"_31":19411},[],{"_33":3020,"_35":19412,"_37":2502,"_39":19413,"_63":19414,"_65":19415,"_67":66},"Sy7mStP6",{},[],"UnorderedList",{"_33":3020,"_35":19417,"_37":2502,"_39":19418,"_63":19419,"_65":19420,"_67":66},"jdRM2qW7",{},[],"GroupingContent",{"_29":19422,"_31":19455},[19423,19430,19437,19443,19449],{"_29":19424,"_31":19425},[],{"_33":2680,"_35":19426,"_37":2502,"_39":19427,"_63":19428,"_65":19429,"_67":66},"7rI1EAKq",{},[],"May have PhrasingContent blocks as children",{"_29":19431,"_31":19432},[],{"_33":3020,"_35":19433,"_37":2502,"_39":19434,"_63":19435,"_65":19436,"_67":66},"LmocCy5q",{},[],"Statement",{"_29":19438,"_31":19439},[],{"_33":3020,"_35":19440,"_37":2502,"_39":19441,"_63":19442,"_65":3020,"_67":66},"yhA1jTXO",{},[],{"_29":19444,"_31":19445},[],{"_33":3020,"_35":19446,"_37":2502,"_39":19447,"_63":19448,"_65":11996,"_67":66},"8WydP6Z9",{},[],{"_29":19450,"_31":19451},[],{"_33":3020,"_35":19452,"_37":2502,"_39":19453,"_63":19454,"_65":2751,"_67":66},"YNPFQdNq",{},[],{"_33":3020,"_35":19456,"_37":2502,"_39":19457,"_63":19458,"_65":19459,"_67":66},"Dgoo0x-q",{},[],"FlowContent",{"_29":19461,"_31":19534},[19462,19473,19487,19493,19499],{"_29":19463,"_31":19464},[],{"_33":2680,"_35":19465,"_37":2502,"_39":19466,"_63":19467,"_65":19472,"_67":66},"_rCUMR0j",{},[19468],{"_33":2751,"_2788":19469,"_2790":19470,"_39":19471,"_67":66},[144],[2965],{},"Link | Embed",{"_29":19474,"_31":19482},[19475],{"_29":19476,"_31":19477},[],{"_33":2751,"_35":19478,"_37":2502,"_39":19479,"_63":19480,"_65":19481,"_67":66},"_fIt_DRR",{"_2753":66},[],"export interface Text extends Literal {\n type: 'text'\n strong?: boolean\n emphasis?: boolean\n underline?: boolean\n strikethrough?: boolean\n superscript?: boolean\n subscript?: boolean\n code?: boolean\n color?: string\n // implementation relevant marks. not persistent\n codeToken?: string\n 'find-highlight'?: boolean\n conversations?: Array\n}\n\n",{"_33":3020,"_35":19483,"_37":2502,"_39":19484,"_63":19485,"_65":19486,"_67":66},"Fxo7_Agb",{},[],"Text",{"_29":19488,"_31":19489},[],{"_33":3020,"_35":19490,"_37":2502,"_39":19491,"_63":19492,"_65":2716,"_67":66},"Re0iz5X5",{},[],{"_29":19494,"_31":19495},[],{"_33":3020,"_35":19496,"_37":2502,"_39":19497,"_63":19498,"_65":6334,"_67":66},"rFYxOhuC",{},[],{"_29":19500,"_31":19529},[19501,19515],{"_29":19502,"_31":19510},[19503],{"_29":19504,"_31":19505},[],{"_33":2680,"_35":19506,"_37":2502,"_39":19507,"_63":19508,"_65":19509,"_67":66},"ALXTwVdg",{},[],"Note: why is \"file\" a Parent?",{"_33":2751,"_35":19511,"_37":2502,"_39":19512,"_63":19513,"_65":19514,"_67":66},"3NhlSr3k",{"_2719":11996,"_2753":66},[],"{\n type: 'file'\n name?: string\n title?: string\n defaultOpen\n children: [???]\n}\n",{"_29":19516,"_31":19524},[19517],{"_29":19518,"_31":19519},[],{"_33":2680,"_35":19520,"_37":2502,"_39":19521,"_63":19522,"_65":19523,"_67":66},"K9YUIBbL",{},[],"Note: what is defaultOpen",{"_33":2680,"_35":19525,"_37":2502,"_39":19526,"_63":19527,"_65":19528,"_67":66},"Cp6XLj7J",{"_2719":11996},[],"Note: what is the difference between title and name?",{"_33":3020,"_35":19530,"_37":2502,"_39":19531,"_63":19532,"_65":19533,"_67":66},"9emcDvnK",{},[],"File",{"_33":3020,"_35":19535,"_37":2502,"_39":19536,"_63":19537,"_65":19538,"_67":66},"B9qfc4L_",{},[],"PhrasingContent",{"_29":19540,"_31":19548},[19541],{"_29":19542,"_31":19543},[],{"_33":2680,"_35":19544,"_37":2502,"_39":19545,"_63":19546,"_65":19547,"_67":66},"2KlUj_R8",{},[],"mttast/types",{"_33":3020,"_35":19549,"_37":2502,"_39":19550,"_63":19551,"_65":14814,"_67":66},"AkHV_DFH",{"_2719":2972},[],[76],"/tech-talks/document-block-types",{"_84":2518},{},{"_90":2502,"_94":2516},{"_35":2499,"_102":51,"_52":19558,"_68":2502,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2501],1779255260448,[156,2499,2502,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-block-types\",\"bafy2bzaceb424vzlgrj45dfv6kfsb4oaatln62bni2cirlgv5m2wpalye22m6\",true]",{"_117":19563,"_154":20292,"_157":20293},{"_119":19564,"_139":42,"_140":20291,"_142":-5,"_143":144,"_145":144,"_146":144,"_147":-5,"_148":-5,"_149":22,"_150":151,"_152":153},{"_33":24,"_24":19565,"_35":20289},{"_26":19566,"_68":2524,"_69":51,"_70":20284,"_52":20285,"_78":2531,"_80":2531,"_82":20286,"_88":20287,"_90":2524,"_92":20288,"_96":97},[19567,19578,19649,19684,19921,19981,20063,20112,20202,20260],{"_29":19568,"_31":19569},[],{"_33":2680,"_35":19570,"_37":2524,"_39":19571,"_63":19572,"_65":19577,"_67":66},"rL4w5r1V",{},[19573],{"_33":2751,"_2788":19574,"_2790":19575,"_39":19576,"_67":66},[1835],[2918],{},"The documentToText function converts hypermedia documents (with all their embeds) to plain text representation. It recursively resolves all inline and block embeds, replacing them with their actual content.",{"_29":19579,"_31":19645},[19580,19595,19606],{"_29":19581,"_31":19582},[],{"_33":2680,"_35":19583,"_37":2524,"_39":19584,"_63":19585,"_65":19594,"_67":66},"2yjKwR-z",{},[19586,19590],{"_33":3084,"_2788":19587,"_2790":19588,"_39":19589,"_67":66},[144],[1057],{},{"_33":2751,"_2788":19591,"_2790":19592,"_39":19593,"_67":66},[7514],[6837],{},"Location: @shm/shared/document-to-text",{"_29":19596,"_31":19597},[],{"_33":2680,"_35":19598,"_37":2524,"_39":19599,"_63":19600,"_65":19605,"_67":66},"VS4fBMiZ",{},[19601],{"_33":3084,"_2788":19602,"_2790":19603,"_39":19604,"_67":66},[144],[882],{},"Purpose: Generate plain text version of documents with resolved embeds",{"_29":19607,"_31":19636},[19608,19615,19622,19629],{"_29":19609,"_31":19610},[],{"_33":2680,"_35":19611,"_37":2524,"_39":19612,"_63":19613,"_65":19614,"_67":66},"2VpxijZR",{},[],"Text fragment rendering with inline embeds resolved",{"_29":19616,"_31":19617},[],{"_33":2680,"_35":19618,"_37":2524,"_39":19619,"_63":19620,"_65":19621,"_67":66},"aWfpFy5M",{},[],"Document search indexing",{"_29":19623,"_31":19624},[],{"_33":2680,"_35":19625,"_37":2524,"_39":19626,"_63":19627,"_65":19628,"_67":66},"1i9ySoY3",{},[],"Export to plain text",{"_29":19630,"_31":19631},[],{"_33":2680,"_35":19632,"_37":2524,"_39":19633,"_63":19634,"_65":19635,"_67":66},"EjfTA5zS",{},[],"Content preview generation",{"_33":2680,"_35":19637,"_37":2524,"_39":19638,"_63":19639,"_65":19644,"_67":66},"1a8Rwxh_",{"_2719":2972},[19640],{"_33":3084,"_2788":19641,"_2790":19642,"_39":19643,"_67":66},[144],[2905],{},"Use Cases:",{"_33":3020,"_35":19646,"_37":2524,"_39":19647,"_63":19648,"_65":18105,"_67":66},"F0NAJYwm",{"_2719":2972},[],{"_29":19650,"_31":19679},[19651,19665],{"_29":19652,"_31":19660},[19653],{"_29":19654,"_31":19655},[],{"_33":2751,"_35":19656,"_37":2524,"_39":19657,"_63":19658,"_65":19659,"_67":66},"RFKRK2P0",{"_2753":13245},[],"async function documentToText({\n documentId,\n grpcClient,\n options = {},\n}: {\n documentId: UnpackedHypermediaId\n grpcClient: GRPCClient\n options: DocumentToTextOptions\n}): Promise\n",{"_33":3020,"_35":19661,"_37":2524,"_39":19662,"_63":19663,"_65":19664,"_67":66},"4Klrb3gU",{"_2719":243},[],"Function Signature",{"_29":19666,"_31":19674},[19667],{"_29":19668,"_31":19669},[],{"_33":2751,"_35":19670,"_37":2524,"_39":19671,"_63":19672,"_65":19673,"_67":66},"_lOG_V_e",{"_2753":13245},[],"interface DocumentToTextOptions {\n maxDepth?: number // Maximum embed depth (default: 10)\n resolveInlineEmbeds?: boolean // Replace inline embeds with doc names (default: true)\n lineBreaks?: boolean // Add line breaks between blocks (default: true)\n}\n",{"_33":3020,"_35":19675,"_37":2524,"_39":19676,"_63":19677,"_65":19678,"_67":66},"A6tUW4tq",{"_2719":243},[],"Options",{"_33":3020,"_35":19680,"_37":2524,"_39":19681,"_63":19682,"_65":19683,"_67":66},"eAdkQ8er",{"_2719":243},[],"API",{"_29":19685,"_31":19916},[19686,19746,19798,19833,19876],{"_29":19687,"_31":19741},[19688],{"_29":19689,"_31":19736},[19690,19697,19704,19711,19722,19729],{"_29":19691,"_31":19692},[],{"_33":2680,"_35":19693,"_37":2524,"_39":19694,"_63":19695,"_65":19696,"_67":66},"ox4K0gvL",{},[],"Paragraphs: Extract text content",{"_29":19698,"_31":19699},[],{"_33":2680,"_35":19700,"_37":2524,"_39":19701,"_63":19702,"_65":19703,"_67":66},"Rk1U2yft",{},[],"Headings: Extract heading text",{"_29":19705,"_31":19706},[],{"_33":2680,"_35":19707,"_37":2524,"_39":19708,"_63":19709,"_65":19710,"_67":66},"hADtk2H6",{},[],"Code blocks: Include code content",{"_29":19712,"_31":19713},[],{"_33":2680,"_35":19714,"_37":2524,"_39":19715,"_63":19716,"_65":19721,"_67":66},"KggYz0tx",{},[19717],{"_33":2751,"_2788":19718,"_2790":19719,"_39":19720,"_67":66},[3243],[2890],{},"Buttons: Extract button labels from attributes.name",{"_29":19723,"_31":19724},[],{"_33":2680,"_35":19725,"_37":2524,"_39":19726,"_63":19727,"_65":19728,"_67":66},"BL6Kz9s3",{},[],"Images/Videos/Files: Include captions",{"_29":19730,"_31":19731},[],{"_33":2680,"_35":19732,"_37":2524,"_39":19733,"_63":19734,"_65":19735,"_67":66},"shYGI7F8",{},[],"Embeds: Recursively fetch and include content",{"_33":2680,"_35":19737,"_37":2524,"_39":19738,"_63":19739,"_65":19740,"_67":66},"8jcOKDJF",{"_2719":2972},[],"Processes document blocks depth-first:",{"_33":3020,"_35":19742,"_37":2524,"_39":19743,"_63":19744,"_65":19745,"_67":66},"sJ16mThx",{"_2719":243},[],"1. Hierarchical Block Processing",{"_29":19747,"_31":19793},[19748,19780,19786],{"_29":19749,"_31":19775},[19750,19757,19764],{"_29":19751,"_31":19752},[],{"_33":2680,"_35":19753,"_37":2524,"_39":19754,"_63":19755,"_65":19756,"_67":66},"sbCX8Z6V",{},[],"Detects inline embed annotations",{"_29":19758,"_31":19759},[],{"_33":2680,"_35":19760,"_37":2524,"_39":19761,"_63":19762,"_65":19763,"_67":66},"QMTvZKWc",{},[],"Fetches referenced document",{"_29":19765,"_31":19766},[],{"_33":2680,"_35":19767,"_37":2524,"_39":19768,"_63":19769,"_65":19774,"_67":66},"w4GrklP3",{},[19770],{"_33":2751,"_2788":19771,"_2790":19772,"_39":19773,"_67":66},[2907],[2792],{},"Replaces marker with @DocumentName",{"_33":2680,"_35":19776,"_37":2524,"_39":19777,"_63":19778,"_65":19779,"_67":66},"bgichije",{"_2719":2972},[],"Replaces invisible character markers (U+FEFF) with document names:",{"_29":19781,"_31":19782},[],{"_33":2680,"_35":19783,"_37":2524,"_39":19784,"_63":19785,"_65":5402,"_67":66},"iduMVkW9",{},[],{"_29":19787,"_31":19788},[],{"_33":2751,"_35":19789,"_37":2524,"_39":19790,"_63":19791,"_65":19792,"_67":66},"b6Ew4AIg",{"_2753":66},[],"\"Check out this post!\" → \"Check out @Alice's Guide this post!\"\n",{"_33":3020,"_35":19794,"_37":2524,"_39":19795,"_63":19796,"_65":19797,"_67":66},"qMh9mU7D",{"_2719":243},[],"2. Inline Embed Resolution",{"_29":19799,"_31":19828},[19800],{"_29":19801,"_31":19823},[19802,19809,19816],{"_29":19803,"_31":19804},[],{"_33":2680,"_35":19805,"_37":2524,"_39":19806,"_63":19807,"_65":19808,"_67":66},"3S4TJjdH",{},[],"Full document embeds",{"_29":19810,"_31":19811},[],{"_33":2680,"_35":19812,"_37":2524,"_39":19813,"_63":19814,"_65":19815,"_67":66},"3hcT50OB",{},[],"Block-specific embeds (blockRef)",{"_29":19817,"_31":19818},[],{"_33":2680,"_35":19819,"_37":2524,"_39":19820,"_63":19821,"_65":19822,"_67":66},"o1xK42ED",{},[],"Block range embeds (blockRef with range)",{"_33":2680,"_35":19824,"_37":2524,"_39":19825,"_63":19826,"_65":19827,"_67":66},"3RmJFSix",{"_2719":2972},[],"Recursively fetches and includes embedded documents:",{"_33":3020,"_35":19829,"_37":2524,"_39":19830,"_63":19831,"_65":19832,"_67":66},"6yQVyD99",{"_2719":243},[],"3. Block Embed Resolution",{"_29":19834,"_31":19871},[19835],{"_29":19836,"_31":19866},[19837,19848,19859],{"_29":19838,"_31":19839},[],{"_33":2680,"_35":19840,"_37":2524,"_39":19841,"_63":19842,"_65":19847,"_67":66},"eCYZCv5a",{},[19843],{"_33":2751,"_2788":19844,"_2790":19845,"_39":19846,"_67":66},[144],[1057],{},"#blockId - Returns only that block's content",{"_29":19849,"_31":19850},[],{"_33":2680,"_35":19851,"_37":2524,"_39":19852,"_63":19853,"_65":19858,"_67":66},"6lTTlb8G",{},[19854],{"_33":2751,"_2788":19855,"_2790":19856,"_39":19857,"_67":66},[144],[2839],{},"#blockId[start:end] - Returns only children within range",{"_29":19860,"_31":19861},[],{"_33":2680,"_35":19862,"_37":2524,"_39":19863,"_63":19864,"_65":19865,"_67":66},"EulEJMTK",{},[],"Respects parent-child relationships",{"_33":2680,"_35":19867,"_37":2524,"_39":19868,"_63":19869,"_65":19870,"_67":66},"Lo2Hm2zC",{"_2719":2972},[],"Handles blockRef and blockRange:",{"_33":3020,"_35":19872,"_37":2524,"_39":19873,"_63":19874,"_65":19875,"_67":66},"DqSFBeU_",{"_2719":243},[],"4. Fragment Support",{"_29":19877,"_31":19911},[19878,19889,19900],{"_29":19879,"_31":19880},[],{"_33":2680,"_35":19881,"_37":2524,"_39":19882,"_63":19883,"_65":19888,"_67":66},"J8-FgKry",{},[19884],{"_33":3084,"_2788":19885,"_2790":19886,"_39":19887,"_67":66},[144],[2889],{},"Circular reference detection: Tracks visited documents",{"_29":19890,"_31":19891},[],{"_33":2680,"_35":19892,"_37":2524,"_39":19893,"_63":19894,"_65":19899,"_67":66},"Ap1tWLza",{},[19895],{"_33":3084,"_2788":19896,"_2790":19897,"_39":19898,"_67":66},[144],[912],{},"Depth limiting: Prevents infinite recursion",{"_29":19901,"_31":19902},[],{"_33":2680,"_35":19903,"_37":2524,"_39":19904,"_63":19905,"_65":19910,"_67":66},"5VebPdSp",{},[19906],{"_33":3084,"_2788":19907,"_2790":19908,"_39":19909,"_67":66},[144],[912],{},"Error handling: Graceful fallbacks for missing content",{"_33":3020,"_35":19912,"_37":2524,"_39":19913,"_63":19914,"_65":19915,"_67":66},"PYNpKC7j",{"_2719":2972},[],"5. Safety Features",{"_33":3020,"_35":19917,"_37":2524,"_39":19918,"_63":19919,"_65":19920,"_67":66},"uKSH3x81",{"_2719":243},[],"Features",{"_29":19922,"_31":19976},[19923,19930,19951],{"_29":19924,"_31":19925},[],{"_33":2680,"_35":19926,"_37":2524,"_39":19927,"_63":19928,"_65":19929,"_67":66},"QsC4xPWo",{},[],"The function is available in both desktop and web apps through the document content context:",{"_29":19931,"_31":19946},[19932,19939],{"_29":19933,"_31":19934},[],{"_33":2680,"_35":19935,"_37":2524,"_39":19936,"_63":19937,"_65":19938,"_67":66},"ehSJmWjF",{},[],"Direct access to grpcClient:",{"_29":19940,"_31":19941},[],{"_33":2751,"_35":19942,"_37":2524,"_39":19943,"_63":19944,"_65":19945,"_67":66},"S4GEFRmw",{"_2753":13245},[],"const {getDocumentText} = useDocContentContext()\n\nconst text = await getDocumentText(documentId, {\n lineBreaks: false,\n resolveInlineEmbeds: true,\n})\n",{"_33":3020,"_35":19947,"_37":2524,"_39":19948,"_63":19949,"_65":19950,"_67":66},"TxoCMZR7",{"_2719":243},[],"Desktop App",{"_29":19952,"_31":19971},[19953,19964],{"_29":19954,"_31":19955},[],{"_33":2680,"_35":19956,"_37":2524,"_39":19957,"_63":19958,"_65":19963,"_67":66},"_F1Xxxx-",{},[19959],{"_33":2751,"_2788":19960,"_2790":19961,"_39":19962,"_67":66},[1182],[439],{},"API endpoint at /hm/api/document-text:",{"_29":19965,"_31":19966},[],{"_33":2751,"_35":19967,"_37":2524,"_39":19968,"_63":19969,"_65":19970,"_67":66},"vxMubJEa",{"_2753":13245},[],"const {getDocumentText} = useDocContentContext()\n\n// Same API, but fetches from server\nconst text = await getDocumentText(documentId, {\n maxDepth: 5,\n resolveInlineEmbeds: true,\n})\n",{"_33":3020,"_35":19972,"_37":2524,"_39":19973,"_63":19974,"_65":19975,"_67":66},"kOhWn-i9",{"_2719":243},[],"Web App",{"_33":3020,"_35":19977,"_37":2524,"_39":19978,"_63":19979,"_65":19980,"_67":66},"L7ETUl2-",{"_2719":243},[],"Cross-Platform Integration",{"_29":19982,"_31":20058},[19983,19996],{"_29":19984,"_31":19992},[19985],{"_29":19986,"_31":19987},[],{"_33":2751,"_35":19988,"_37":2524,"_39":19989,"_63":19990,"_65":19991,"_67":66},"0rbj3DcF",{"_2753":66},[],"Desktop:\n Component → useDocContentContext() → documentToText(grpcClient) → Text\n\nWeb:\n Component → useDocContentContext() → API /hm/api/document-text → documentToText(grpcClient) → Text\n",{"_33":3020,"_35":19993,"_37":2524,"_39":19994,"_63":19995,"_65":1408,"_67":66},"SWuYmaiu",{"_2719":243},[],{"_29":19997,"_31":20053},[19998,20009,20020,20031,20042],{"_29":19999,"_31":20000},[],{"_33":2680,"_35":20001,"_37":2524,"_39":20002,"_63":20003,"_65":20008,"_67":66},"wI-wCXnr",{},[20004],{"_33":2751,"_2788":20005,"_2790":20006,"_39":20007,"_67":66},[144],[6365],{},"frontend/packages/shared/src/document-to-text.ts - Core implementation",{"_29":20010,"_31":20011},[],{"_33":2680,"_35":20012,"_37":2524,"_39":20013,"_63":20014,"_65":20019,"_67":66},"-pBL1mqg",{},[20015],{"_33":2751,"_2788":20016,"_2790":20017,"_39":20018,"_67":66},[144],[2817],{},"frontend/packages/shared/src/document-content-types.ts - Context interface",{"_29":20021,"_31":20022},[],{"_33":2680,"_35":20023,"_37":2524,"_39":20024,"_63":20025,"_65":20030,"_67":66},"_6ZxJjid",{},[20026],{"_33":2751,"_2788":20027,"_2790":20028,"_39":20029,"_67":66},[144],[8079],{},"frontend/apps/desktop/src/pages/document-content-provider.tsx - Desktop provider",{"_29":20032,"_31":20033},[],{"_33":2680,"_35":20034,"_37":2524,"_39":20035,"_63":20036,"_65":20041,"_67":66},"cgHf7iBb",{},[20037],{"_33":2751,"_2788":20038,"_2790":20039,"_39":20040,"_67":66},[144],[2822],{},"frontend/apps/web/app/doc-content-provider.tsx - Web provider",{"_29":20043,"_31":20044},[],{"_33":2680,"_35":20045,"_37":2524,"_39":20046,"_63":20047,"_65":20052,"_67":66},"wd0CkdCC",{},[20048],{"_33":2751,"_2788":20049,"_2790":20050,"_39":20051,"_67":66},[144],[6572],{},"frontend/apps/web/app/routes/hm.api.document-text.tsx - Web API endpoint",{"_33":3020,"_35":20054,"_37":2524,"_39":20055,"_63":20056,"_65":20057,"_67":66},"aKj4ju1t",{"_2719":2972},[],"Key Files",{"_33":3020,"_35":20059,"_37":2524,"_39":20060,"_63":20061,"_65":20062,"_67":66},"R_CnHL6x",{"_2719":243},[],"Implementation Details",{"_29":20064,"_31":20107},[20065,20079,20093],{"_29":20066,"_31":20074},[20067],{"_29":20068,"_31":20069},[],{"_33":2751,"_35":20070,"_37":2524,"_39":20071,"_63":20072,"_65":20073,"_67":66},"oMalA2nj",{"_2753":13245},[],"import {documentToText, hmId} from '@shm/shared'\nimport {grpcClient} from './grpc-client'\n\nconst documentId = hmId('account123', {path: ['my-doc']})\nconst text = await documentToText({\n documentId,\n grpcClient,\n options: {},\n})\nconsole.log(text)\n",{"_33":3020,"_35":20075,"_37":2524,"_39":20076,"_63":20077,"_65":20078,"_67":66},"JDfdul2h",{"_2719":243},[],"Basic Usage",{"_29":20080,"_31":20088},[20081],{"_29":20082,"_31":20083},[],{"_33":2751,"_35":20084,"_37":2524,"_39":20085,"_63":20086,"_65":20087,"_67":66},"fnzf6VPT",{"_2753":13245},[],"// Compact text without line breaks\nconst compactText = await documentToText({\n documentId,\n grpcClient,\n options: {\n lineBreaks: false,\n maxDepth: 5,\n resolveInlineEmbeds: true,\n },\n})\n\n// Without inline embed resolution (keep original text)\nconst rawText = await documentToText({\n documentId,\n grpcClient,\n options: {\n resolveInlineEmbeds: false,\n },\n})\n",{"_33":3020,"_35":20089,"_37":2524,"_39":20090,"_63":20091,"_65":20092,"_67":66},"V3TZ73lm",{"_2719":243},[],"With Options",{"_29":20094,"_31":20102},[20095],{"_29":20096,"_31":20097},[],{"_33":2751,"_35":20098,"_37":2524,"_39":20099,"_63":20100,"_65":20101,"_67":66},"6uWCLbY4",{"_2753":13245},[],"function MyComponent({docId}: {docId: UnpackedHypermediaId}) {\n const {getDocumentText} = useDocContentContext()\n const [text, setText] = useState('')\n\n useEffect(() => {\n getDocumentText?.(docId, {lineBreaks: false})\n .then(setText)\n .catch(console.error)\n }, [docId, getDocumentText])\n\n return {text} \n}\n",{"_33":3020,"_35":20103,"_37":2524,"_39":20104,"_63":20105,"_65":20106,"_67":66},"kGrqbGK8",{"_2719":243},[],"In React Components",{"_33":3020,"_35":20108,"_37":2524,"_39":20109,"_63":20110,"_65":20111,"_67":66},"zt6huspZ",{"_2719":243},[],"Usage Examples",{"_29":20113,"_31":20198},[20114,20184,20191],{"_29":20115,"_31":20179},[20116,20123,20130,20137,20144,20151,20158,20165,20172],{"_29":20117,"_31":20118},[],{"_33":2680,"_35":20119,"_37":2524,"_39":20120,"_63":20121,"_65":20122,"_67":66},"Qu33ZZxI",{},[],"Basic text extraction",{"_29":20124,"_31":20125},[],{"_33":2680,"_35":20126,"_37":2524,"_39":20127,"_63":20128,"_65":20129,"_67":66},"Sor5obQF",{},[],"Inline embed resolution",{"_29":20131,"_31":20132},[],{"_33":2680,"_35":20133,"_37":2524,"_39":20134,"_63":20135,"_65":20136,"_67":66},"AHtRxHrt",{},[],"Block embed processing",{"_29":20138,"_31":20139},[],{"_33":2680,"_35":20140,"_37":2524,"_39":20141,"_63":20142,"_65":20143,"_67":66},"Ozha4mZZ",{},[],"Nested structures",{"_29":20145,"_31":20146},[],{"_33":2680,"_35":20147,"_37":2524,"_39":20148,"_63":20149,"_65":20150,"_67":66},"FIvq_W4U",{},[],"Circular reference detection",{"_29":20152,"_31":20153},[],{"_33":2680,"_35":20154,"_37":2524,"_39":20155,"_63":20156,"_65":20157,"_67":66},"qBCOdnsa",{},[],"Max depth handling",{"_29":20159,"_31":20160},[],{"_33":2680,"_35":20161,"_37":2524,"_39":20162,"_63":20163,"_65":20164,"_67":66},"glQ2zRwI",{},[],"BlockRef/BlockRange fragments",{"_29":20166,"_31":20167},[],{"_33":2680,"_35":20168,"_37":2524,"_39":20169,"_63":20170,"_65":20171,"_67":66},"ef2RkrfF",{},[],"Button and heading extraction",{"_29":20173,"_31":20174},[],{"_33":2680,"_35":20175,"_37":2524,"_39":20176,"_63":20177,"_65":20178,"_67":66},"RQDs77oK",{},[],"LineBreaks option",{"_33":2680,"_35":20180,"_37":2524,"_39":20181,"_63":20182,"_65":20183,"_67":66},"FLgcLBRl",{"_2719":2972},[],"17 comprehensive tests covering:",{"_29":20185,"_31":20186},[],{"_33":2680,"_35":20187,"_37":2524,"_39":20188,"_63":20189,"_65":20190,"_67":66},"qxBaH-Tu",{},[],"Run tests:",{"_29":20192,"_31":20193},[],{"_33":2751,"_35":20194,"_37":2524,"_39":20195,"_63":20196,"_65":20197,"_67":66},"MfvNOt1b",{"_2753":9883},[],"NODE_ENV=test yarn workspace @shm/shared test run document-to-text\n",{"_33":3020,"_35":20199,"_37":2524,"_39":20200,"_63":20201,"_65":14441,"_67":66},"X8Uf4__I",{"_2719":243},[],{"_29":20203,"_31":20256},[20204,20215,20230,20245],{"_29":20205,"_31":20206},[],{"_33":2680,"_35":20207,"_37":2524,"_39":20208,"_63":20209,"_65":20214,"_67":66},"NgQXvzk7",{},[20210],{"_33":3084,"_2788":20211,"_2790":20212,"_39":20213,"_67":66},[144],[882],{},"Caching: Consider caching results for frequently accessed documents",{"_29":20216,"_31":20217},[],{"_33":2680,"_35":20218,"_37":2524,"_39":20219,"_63":20220,"_65":20229,"_67":66},"7HYuySWW",{},[20221,20225],{"_33":3084,"_2788":20222,"_2790":20223,"_39":20224,"_67":66},[144],[912],{},{"_33":2751,"_2788":20226,"_2790":20227,"_39":20228,"_67":66},[2551],[2889],{},"Depth limiting: Use maxDepth option for large document trees",{"_29":20231,"_31":20232},[],{"_33":2680,"_35":20233,"_37":2524,"_39":20234,"_63":20235,"_65":20244,"_67":66},"JG_RnhdZ",{},[20236,20240],{"_33":3084,"_2788":20237,"_2790":20238,"_39":20239,"_67":66},[144],[2805],{},{"_33":2751,"_2788":20241,"_2790":20242,"_39":20243,"_67":66},[3926],[2878],{},"Inline embeds: Disabling resolveInlineEmbeds improves performance",{"_29":20246,"_31":20247},[],{"_33":2680,"_35":20248,"_37":2524,"_39":20249,"_63":20250,"_65":20255,"_67":66},"G8aL95t-",{},[20251],{"_33":3084,"_2788":20252,"_2790":20253,"_39":20254,"_67":66},[144],[390],{},"Async: Function is async and may take time for deep embed trees",{"_33":3020,"_35":20257,"_37":2524,"_39":20258,"_63":20259,"_65":18874,"_67":66},"oy86ioXd",{"_2719":2972},[],{"_29":20261,"_31":20280},[20262,20268,20274],{"_29":20263,"_31":20264},[],{"_33":2680,"_35":20265,"_37":2524,"_39":20266,"_63":20267,"_65":2475,"_67":66},"6CMsQMZA",{},[],{"_29":20269,"_31":20270},[],{"_33":2680,"_35":20271,"_37":2524,"_39":20272,"_63":20273,"_65":19041,"_67":66},"KGUb_cb3",{},[],{"_29":20275,"_31":20276},[],{"_33":2680,"_35":20277,"_37":2524,"_39":20278,"_63":20279,"_65":19029,"_67":66},"h_fNcIwy",{},[],{"_33":3020,"_35":20281,"_37":2524,"_39":20282,"_63":20283,"_65":19046,"_67":66},"je8VphVk",{"_2719":2972},[],[76],"/tech-talks/document-to-text-function",{"_84":2540},{},{"_90":2524,"_94":2538},{"_35":2521,"_102":51,"_52":20290,"_68":2524,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_101":6},[53,2523],1779255260444,[156,2521,2524,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-to-text-function\",\"bafy2bzacecdcvfpp3eagebhnu4eolfvyon2pfvp2ykl4qnidggatkabnsumem\",true]","ssrContentHTML","","enableWebSigning","https://semillabitcoin.com","origin","homeMetadata",{"_84":20301,"_189":20302,"_190":66,"_192":20303,"_194":22},"Semilla Bitcoin","ipfs://bafkreiboc3zxukuy3m52t2febpgzewddzymu47k3dqajb5ldqnl5dd5qpu","https://semillabitcoin.hyper.media","originHomeId",{"_102":20306,"_35":20307,"_52":20308,"_68":-5,"_104":-5,"_105":-5,"_106":-5,"_107":-5},"z6MkpUcHwYskCexXimKCu5QGa9eMBkTx62ouTkcB8noHjydr","hm://z6MkpUcHwYskCexXimKCu5QGa9eMBkTx62ouTkcB8noHjydr",[],"meta",{"_20311":20312,"_21680":21681},"values",{"_20313":20314,"_20316":20317,"_20318":20319,"_20320":20321,"_20323":20324,"_20325":20326,"_20327":20328,"_20330":20331,"_20332":20333,"_20334":20335,"_20336":20337,"_20338":20339,"_20340":20341,"_20342":20343,"_20344":20345,"_20346":20347,"_20348":20349,"_20350":20351,"_20352":20353,"_20354":20355,"_20356":20357,"_20358":20359,"_20360":20361,"_20362":20363,"_20364":20365,"_20366":20367,"_20368":20369,"_20370":20371,"_20372":20373,"_20374":20375,"_20376":20377,"_20378":20379,"_20380":20381,"_20382":20383,"_20384":20385,"_20386":20387,"_20388":20389,"_20390":20391,"_20392":20393,"_20394":20395,"_20396":20397,"_20398":20399,"_20400":20401,"_20402":20403,"_20404":20405,"_20406":20407,"_20408":20409,"_20410":20411,"_20412":20413,"_20414":20415,"_20416":20417,"_20418":20419,"_20420":20421,"_20422":20423,"_20424":20425,"_20426":20427,"_20428":20429,"_20430":20431,"_20432":20433,"_20434":20435,"_20436":20437,"_20438":20439,"_20440":20441,"_20442":20443,"_20444":20445,"_20446":20447,"_20448":20449,"_20450":20451,"_20452":20453,"_20454":20455,"_20456":20457,"_20458":20459,"_20460":20461,"_20462":20463,"_20464":20465,"_20466":20467,"_20468":20469,"_20470":20471,"_20472":20473,"_20474":20475,"_20476":20477,"_20478":20479,"_20480":20481,"_20482":20483,"_20484":20485,"_20486":20487,"_20488":20489,"_20490":20491,"_20492":20493,"_20494":20495,"_20496":20497,"_20498":20499,"_20500":20501,"_20502":20503,"_20504":20505,"_20506":20507,"_20508":20509,"_20510":20511,"_20512":20513,"_20514":20515,"_20516":20517,"_20518":20519,"_20520":20521,"_20522":20523,"_20524":20525,"_20526":20527,"_20528":20529,"_20530":20531,"_20532":20533,"_20534":20535,"_20536":20537,"_20538":20539,"_20540":20541,"_20542":20543,"_20544":20545,"_20546":20547,"_20548":20549,"_20550":20551,"_20552":20553,"_20554":20555,"_20556":20557,"_20558":20559,"_20560":20561,"_20562":20563,"_20564":20565,"_20566":20567,"_20568":20569,"_20570":20571,"_20572":20573,"_20574":20575,"_20576":20577,"_20578":20579,"_20580":20581,"_20582":20583,"_20584":20585,"_20586":20587,"_20588":20589,"_20590":20591,"_20592":20593,"_20594":20595,"_20596":20597,"_20598":20599,"_20600":20601,"_20602":20603,"_20604":20605,"_20606":20607,"_20608":20609,"_20610":20611,"_20612":20613,"_20614":20615,"_20616":20617,"_20618":20619,"_20620":20621,"_20622":20623,"_20624":20625,"_20626":20627,"_20628":20629,"_20630":20631,"_20632":20633,"_20634":20635,"_20636":20637,"_20638":20639,"_20640":20641,"_20642":20643,"_20644":20645,"_20646":20647,"_20648":20649,"_20650":20651,"_20652":20653,"_20654":20655,"_20656":20657,"_20658":20659,"_20660":20661,"_20662":20663,"_20664":20665,"_20666":20667,"_20668":20669,"_20670":20671,"_20672":20673,"_20674":20675,"_20676":20677,"_20678":20679,"_20680":20681,"_20682":20683,"_20684":20685,"_20686":20687,"_20688":20689,"_20690":20691,"_20692":20693,"_20694":20695,"_20696":20697,"_20698":20699,"_20700":20701,"_20702":20703,"_20704":20705,"_20706":20707,"_20708":20709,"_20710":20711,"_20712":20713,"_20714":20715,"_20716":20717,"_20718":20719,"_20720":20721,"_20722":20723,"_20724":20725,"_20726":20727,"_20728":20729,"_20730":20731,"_20732":20733,"_20734":20735,"_20736":20737,"_20738":20739,"_20740":20741,"_20742":20743,"_20744":20745,"_20746":20747,"_20748":20749,"_20750":20751,"_20752":20753,"_20754":20755,"_20756":20757,"_20758":20759,"_20760":20761,"_20762":20763,"_20764":20765,"_20766":20767,"_20768":20769,"_20770":20771,"_20772":20773,"_20774":20775,"_20776":20777,"_20778":20779,"_20780":20781,"_20782":20783,"_20784":20785,"_20786":20787,"_20788":20789,"_20790":20791,"_20792":20793,"_20794":20795,"_20796":20797,"_20798":20799,"_20800":20801,"_20802":20803,"_20804":20805,"_20806":20807,"_20808":20809,"_20810":20811,"_20812":20813,"_20814":20815,"_20816":20817,"_20818":20819,"_20820":20821,"_20822":20823,"_20824":20825,"_20826":20827,"_20828":20829,"_20830":20831,"_20832":20833,"_20834":20835,"_20836":20837,"_20838":20839,"_20840":20841,"_20842":20843,"_20844":20845,"_20846":20847,"_20848":20849,"_20850":20851,"_20852":20853,"_20854":20855,"_20856":20857,"_20858":20859,"_20860":20861,"_20862":20863,"_20864":20865,"_20866":20867,"_20868":20869,"_20870":20871,"_20872":20873,"_20874":20875,"_20876":20877,"_20878":20879,"_20880":20881,"_20882":20883,"_20884":20885,"_20886":20887,"_20888":20889,"_20890":20891,"_20892":20893,"_20894":20895,"_20896":20897,"_20898":20899,"_20900":20901,"_20902":20903,"_20904":20905,"_20906":20907,"_20908":20909,"_20910":20911,"_20912":20913,"_20914":20915,"_20916":20917,"_20918":20919,"_20920":20921,"_20922":20923,"_20924":20925,"_20926":20927,"_20928":20929,"_20930":20931,"_20932":20933,"_20934":20935,"_20936":20937,"_20938":20939,"_20940":20941,"_20942":20943,"_20944":20945,"_20946":20947,"_20948":20949,"_20950":20951,"_20952":20953,"_20954":20955,"_20956":20957,"_20958":20959,"_20960":20961,"_20962":20963,"_20964":20965,"_20966":20967,"_20968":20969,"_20970":20971,"_20972":20973,"_20974":20975,"_20976":20977,"_20978":20979,"_20980":20981,"_20982":20983,"_20984":20985,"_20986":20987,"_20988":20989,"_20990":20991,"_20992":20993,"_20994":20995,"_20996":20997,"_20998":20999,"_21000":21001,"_21002":21003,"_21004":21005,"_21006":21007,"_21008":21009,"_21010":21011,"_21012":21013,"_21014":21015,"_21016":21017,"_21018":21019,"_21020":21021,"_21022":21023,"_21024":21025,"_21026":21027,"_21028":21029,"_21030":21031,"_21032":21033,"_21034":21035,"_21036":21037,"_21038":21039,"_21040":21041,"_21042":21043,"_21044":21045,"_21046":21047,"_21048":21049,"_21050":21051,"_21052":21053,"_21054":21055,"_21056":21057,"_21058":21059,"_21060":21061,"_21062":21063,"_21064":21065,"_21066":21067,"_21068":21069,"_21070":21071,"_21072":21073,"_21074":21075,"_21076":21077,"_21078":21079,"_21080":21081,"_21082":21083,"_21084":21085,"_21086":21087,"_21088":21089,"_21090":21091,"_21092":21093,"_21094":21095,"_21096":21097,"_21098":21099,"_21100":21101,"_21102":21103,"_21104":21105,"_21106":21107,"_21108":21109,"_21110":21111,"_21112":21113,"_21114":21115,"_21116":21117,"_21118":21119,"_21120":21121,"_21122":21123,"_21124":21125,"_21126":21127,"_21128":21129,"_21130":21131,"_21132":21133,"_21134":21135,"_21136":21137,"_21138":21139,"_21140":21141,"_21142":21143,"_21144":21145,"_21146":21147,"_21148":21149,"_21150":21151,"_21152":21153,"_21154":21155,"_21156":21157,"_21158":21159,"_21160":21161,"_21162":21163,"_21164":21165,"_21166":21167,"_21168":21169,"_21170":21171,"_21172":21173,"_21174":21175,"_21176":21177,"_21178":21179,"_21180":21181,"_21182":21183,"_21184":21185,"_21186":21187,"_21188":21189,"_21190":21191,"_21192":21193,"_21194":21195,"_21196":21197,"_21198":21199,"_21200":21201,"_21202":21203,"_21204":21205,"_21206":21207,"_21208":21209,"_21210":21211,"_21212":21213,"_21214":21215,"_21216":21217,"_21218":21219,"_21220":21221,"_21222":21223,"_21224":21225,"_21226":21227,"_21228":21229,"_21230":21231,"_21232":21233,"_21234":21235,"_21236":21237,"_21238":21239,"_21240":21241,"_21242":21243,"_21244":21245,"_21246":21247,"_21248":21249,"_21250":21251,"_21252":21253,"_21254":21255,"_21256":21257,"_21258":21259,"_21260":21261,"_21262":21263,"_21264":21265,"_21266":21267,"_21268":21269,"_21270":21271,"_21272":21273,"_21274":21275,"_21276":21277,"_21278":21279,"_21280":21281,"_21282":21283,"_21284":21285,"_21286":21287,"_21288":21289,"_21290":21291,"_21292":21293,"_21294":21295,"_21296":21297,"_21298":21299,"_21300":21301,"_21302":21303,"_21304":21305,"_21306":21307,"_21308":21309,"_21310":21311,"_21312":21313,"_21314":21315,"_21316":21317,"_21318":21319,"_21320":21321,"_21322":21323,"_21324":21325,"_21326":21327,"_21328":21329,"_21330":21331,"_21332":21333,"_21334":21335,"_21336":21337,"_21338":21339,"_21340":21341,"_21342":21343,"_21344":21345,"_21346":21347,"_21348":21349,"_21350":21351,"_21352":21353,"_21354":21355,"_21356":21357,"_21358":21359,"_21360":21361,"_21362":21363,"_21364":21365,"_21366":21367,"_21368":21369,"_21370":21371,"_21372":21373,"_21374":21375,"_21376":21377,"_21378":21379,"_21380":21381,"_21382":21383,"_21384":21385,"_21386":21387,"_21388":21389,"_21390":21391,"_21392":21393,"_21394":21395,"_21396":21397,"_21398":21399,"_21400":21401,"_21402":21403,"_21404":21405,"_21406":21407,"_21408":21409,"_21410":21411,"_21412":21413,"_21414":21415,"_21416":21417,"_21418":21419,"_21420":21421,"_21422":21423,"_21424":21425,"_21426":21427,"_21428":21429,"_21430":21431,"_21432":21433,"_21434":21435,"_21436":21437,"_21438":21439,"_21440":21441,"_21442":21443,"_21444":21445,"_21446":21447,"_21448":21449,"_21450":21451,"_21452":21453,"_21454":21455,"_21456":21457,"_21458":21459,"_21460":21461,"_21462":21463,"_21464":21465,"_21466":21467,"_21468":21469,"_21470":21471,"_21472":21473,"_21474":21475,"_21476":21477,"_21478":21479,"_21480":21481,"_21482":21483,"_21484":21485,"_21486":21487,"_21488":21489,"_21490":21491,"_21492":21493,"_21494":21495,"_21496":21497,"_21498":21499,"_21500":21501,"_21502":21503,"_21504":21505,"_21506":21507,"_21508":21509,"_21510":21511,"_21512":21513,"_21514":21515,"_21516":21517,"_21518":21519,"_21520":21521,"_21522":21523,"_21524":21525,"_21526":21527,"_21528":21529,"_21530":21531,"_21532":21533,"_21534":21535,"_21536":21537,"_21538":21539,"_21540":21541,"_21542":21543,"_21544":21545,"_21546":21547,"_21548":21549,"_21550":21551,"_21552":21553,"_21554":21555,"_21556":21557,"_21558":21559,"_21560":21561,"_21562":21563,"_21564":21565,"_21566":21567,"_21568":21569,"_21570":21571,"_21572":21573,"_21574":21575,"_21576":21577,"_21578":21579,"_21580":21581,"_21582":21583,"_21584":21585,"_21586":21587,"_21588":21589,"_21590":21591,"_21592":21593,"_21594":21595,"_21596":21597,"_21598":21599,"_21600":21601,"_21602":21603,"_21604":21605,"_21606":21607,"_21608":21609,"_21610":21611,"_21612":21613,"_21614":21615,"_21616":21617,"_21618":21619,"_21620":21621,"_21622":21623,"_21624":21625,"_21626":21627,"_21628":21629,"_21630":21631,"_21632":21633,"_21634":21635,"_21636":21637,"_21638":21639,"_21640":21641,"_21642":21643,"_21644":21645,"_21646":21647,"_21648":21649,"_21650":21651,"_21652":21653,"_21654":21655,"_21656":21657,"_21658":21659,"_21660":21661,"_21662":21663,"_21664":21665,"_21666":21667,"_21668":21669,"_21670":21671,"_21672":21673,"_21674":21675,"_21676":21677,"_21678":21679},"document.generationInfo.generation",[20315],"bigint","dehydratedState.queries.0.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.1.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.1.queryKey.2",[20322],"undefined","dehydratedState.queries.2.state.data.0.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.0.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.0.sortTime",[20329],"Date","dehydratedState.queries.2.state.data.0.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.0.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.0.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.0.redirectInfo",[20322],"dehydratedState.queries.2.state.data.1.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.1.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.1.sortTime",[20329],"dehydratedState.queries.2.state.data.1.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.1.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.1.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.1.redirectInfo",[20322],"dehydratedState.queries.2.state.data.2.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.2.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.2.sortTime",[20329],"dehydratedState.queries.2.state.data.2.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.2.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.2.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.2.redirectInfo",[20322],"dehydratedState.queries.2.state.data.3.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.3.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.3.sortTime",[20329],"dehydratedState.queries.2.state.data.3.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.3.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.3.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.3.redirectInfo",[20322],"dehydratedState.queries.2.state.data.4.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.4.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.4.sortTime",[20329],"dehydratedState.queries.2.state.data.4.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.4.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.4.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.4.redirectInfo",[20322],"dehydratedState.queries.2.state.data.5.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.5.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.5.sortTime",[20329],"dehydratedState.queries.2.state.data.5.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.5.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.5.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.5.redirectInfo",[20322],"dehydratedState.queries.2.state.data.6.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.6.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.6.sortTime",[20329],"dehydratedState.queries.2.state.data.6.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.6.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.6.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.6.redirectInfo",[20322],"dehydratedState.queries.2.state.data.7.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.7.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.7.sortTime",[20329],"dehydratedState.queries.2.state.data.7.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.7.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.7.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.7.redirectInfo",[20322],"dehydratedState.queries.2.state.data.8.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.8.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.8.sortTime",[20329],"dehydratedState.queries.2.state.data.8.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.8.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.8.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.8.redirectInfo",[20322],"dehydratedState.queries.2.state.data.9.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.9.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.9.sortTime",[20329],"dehydratedState.queries.2.state.data.9.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.9.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.9.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.9.redirectInfo",[20322],"dehydratedState.queries.2.state.data.10.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.10.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.10.sortTime",[20329],"dehydratedState.queries.2.state.data.10.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.10.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.10.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.10.redirectInfo",[20322],"dehydratedState.queries.2.state.data.11.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.11.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.11.sortTime",[20329],"dehydratedState.queries.2.state.data.11.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.11.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.11.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.11.redirectInfo",[20322],"dehydratedState.queries.2.state.data.12.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.12.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.12.sortTime",[20329],"dehydratedState.queries.2.state.data.12.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.12.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.12.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.12.redirectInfo",[20322],"dehydratedState.queries.2.state.data.13.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.13.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.13.sortTime",[20329],"dehydratedState.queries.2.state.data.13.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.13.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.13.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.13.redirectInfo",[20322],"dehydratedState.queries.2.state.data.14.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.14.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.14.sortTime",[20329],"dehydratedState.queries.2.state.data.14.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.14.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.14.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.14.redirectInfo",[20322],"dehydratedState.queries.2.state.data.15.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.15.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.15.sortTime",[20329],"dehydratedState.queries.2.state.data.15.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.15.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.15.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.15.redirectInfo",[20322],"dehydratedState.queries.2.state.data.16.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.16.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.16.sortTime",[20329],"dehydratedState.queries.2.state.data.16.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.16.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.16.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.16.redirectInfo",[20322],"dehydratedState.queries.2.state.data.17.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.17.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.17.sortTime",[20329],"dehydratedState.queries.2.state.data.17.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.17.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.17.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.17.redirectInfo",[20322],"dehydratedState.queries.2.state.data.18.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.18.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.18.sortTime",[20329],"dehydratedState.queries.2.state.data.18.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.18.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.18.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.18.redirectInfo",[20322],"dehydratedState.queries.2.state.data.19.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.19.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.19.sortTime",[20329],"dehydratedState.queries.2.state.data.19.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.19.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.19.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.19.redirectInfo",[20322],"dehydratedState.queries.2.state.data.20.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.20.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.20.sortTime",[20329],"dehydratedState.queries.2.state.data.20.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.20.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.20.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.20.redirectInfo",[20322],"dehydratedState.queries.2.state.data.21.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.21.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.21.sortTime",[20329],"dehydratedState.queries.2.state.data.21.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.21.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.21.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.21.redirectInfo",[20322],"dehydratedState.queries.2.state.data.22.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.22.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.22.sortTime",[20329],"dehydratedState.queries.2.state.data.22.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.22.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.22.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.22.redirectInfo",[20322],"dehydratedState.queries.2.state.data.23.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.23.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.23.sortTime",[20329],"dehydratedState.queries.2.state.data.23.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.23.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.23.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.23.redirectInfo",[20322],"dehydratedState.queries.2.state.data.24.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.24.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.24.sortTime",[20329],"dehydratedState.queries.2.state.data.24.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.24.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.24.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.24.redirectInfo",[20322],"dehydratedState.queries.2.state.data.25.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.25.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.25.sortTime",[20329],"dehydratedState.queries.2.state.data.25.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.25.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.25.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.25.redirectInfo",[20322],"dehydratedState.queries.2.state.data.26.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.26.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.26.sortTime",[20329],"dehydratedState.queries.2.state.data.26.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.26.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.26.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.26.redirectInfo",[20322],"dehydratedState.queries.2.state.data.27.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.27.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.27.sortTime",[20329],"dehydratedState.queries.2.state.data.27.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.27.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.27.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.27.redirectInfo",[20322],"dehydratedState.queries.2.state.data.28.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.28.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.28.sortTime",[20329],"dehydratedState.queries.2.state.data.28.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.28.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.28.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.28.redirectInfo",[20322],"dehydratedState.queries.2.state.data.29.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.29.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.29.sortTime",[20329],"dehydratedState.queries.2.state.data.29.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.29.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.29.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.29.redirectInfo",[20322],"dehydratedState.queries.2.state.data.30.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.30.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.30.sortTime",[20329],"dehydratedState.queries.2.state.data.30.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.30.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.30.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.30.redirectInfo",[20322],"dehydratedState.queries.2.state.data.31.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.31.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.31.sortTime",[20329],"dehydratedState.queries.2.state.data.31.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.31.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.31.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.31.redirectInfo",[20322],"dehydratedState.queries.2.state.data.32.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.32.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.32.sortTime",[20329],"dehydratedState.queries.2.state.data.32.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.32.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.32.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.32.redirectInfo",[20322],"dehydratedState.queries.2.state.data.33.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.33.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.33.sortTime",[20329],"dehydratedState.queries.2.state.data.33.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.33.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.33.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.33.redirectInfo",[20322],"dehydratedState.queries.2.state.data.34.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.34.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.34.sortTime",[20329],"dehydratedState.queries.2.state.data.34.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.34.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.34.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.34.redirectInfo",[20322],"dehydratedState.queries.2.state.data.35.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.35.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.35.sortTime",[20329],"dehydratedState.queries.2.state.data.35.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.2.state.data.35.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.35.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.35.redirectInfo",[20322],"dehydratedState.queries.2.state.data.36.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.36.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.36.sortTime",[20329],"dehydratedState.queries.2.state.data.36.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.36.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.36.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.36.redirectInfo",[20322],"dehydratedState.queries.2.state.data.37.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.37.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.37.sortTime",[20329],"dehydratedState.queries.2.state.data.37.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.37.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.37.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.37.redirectInfo",[20322],"dehydratedState.queries.2.state.data.38.createTime.seconds",[20315],"dehydratedState.queries.2.state.data.38.updateTime.seconds",[20315],"dehydratedState.queries.2.state.data.38.sortTime",[20329],"dehydratedState.queries.2.state.data.38.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.2.state.data.38.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.2.state.data.38.generationInfo.generation",[20315],"dehydratedState.queries.2.state.data.38.redirectInfo",[20322],"dehydratedState.queries.3.state.data.0.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.0.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.0.sortTime",[20329],"dehydratedState.queries.3.state.data.0.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.0.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.0.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.0.redirectInfo",[20322],"dehydratedState.queries.3.state.data.1.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.1.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.1.sortTime",[20329],"dehydratedState.queries.3.state.data.1.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.1.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.1.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.1.redirectInfo",[20322],"dehydratedState.queries.3.state.data.2.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.2.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.2.sortTime",[20329],"dehydratedState.queries.3.state.data.2.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.2.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.2.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.2.redirectInfo",[20322],"dehydratedState.queries.3.state.data.3.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.3.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.3.sortTime",[20329],"dehydratedState.queries.3.state.data.3.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.3.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.3.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.3.redirectInfo",[20322],"dehydratedState.queries.3.state.data.4.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.4.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.4.sortTime",[20329],"dehydratedState.queries.3.state.data.4.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.4.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.4.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.4.redirectInfo",[20322],"dehydratedState.queries.3.state.data.5.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.5.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.5.sortTime",[20329],"dehydratedState.queries.3.state.data.5.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.5.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.5.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.5.redirectInfo",[20322],"dehydratedState.queries.3.state.data.6.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.6.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.6.sortTime",[20329],"dehydratedState.queries.3.state.data.6.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.6.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.6.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.6.redirectInfo",[20322],"dehydratedState.queries.3.state.data.7.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.7.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.7.sortTime",[20329],"dehydratedState.queries.3.state.data.7.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.7.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.7.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.7.redirectInfo",[20322],"dehydratedState.queries.3.state.data.8.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.8.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.8.sortTime",[20329],"dehydratedState.queries.3.state.data.8.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.8.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.8.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.8.redirectInfo",[20322],"dehydratedState.queries.3.state.data.9.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.9.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.9.sortTime",[20329],"dehydratedState.queries.3.state.data.9.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.9.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.9.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.9.redirectInfo",[20322],"dehydratedState.queries.3.state.data.10.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.10.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.10.sortTime",[20329],"dehydratedState.queries.3.state.data.10.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.10.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.10.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.10.redirectInfo",[20322],"dehydratedState.queries.3.state.data.11.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.11.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.11.sortTime",[20329],"dehydratedState.queries.3.state.data.11.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.11.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.11.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.11.redirectInfo",[20322],"dehydratedState.queries.3.state.data.12.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.12.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.12.sortTime",[20329],"dehydratedState.queries.3.state.data.12.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.12.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.12.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.12.redirectInfo",[20322],"dehydratedState.queries.3.state.data.13.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.13.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.13.sortTime",[20329],"dehydratedState.queries.3.state.data.13.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.13.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.13.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.13.redirectInfo",[20322],"dehydratedState.queries.3.state.data.14.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.14.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.14.sortTime",[20329],"dehydratedState.queries.3.state.data.14.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.14.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.14.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.14.redirectInfo",[20322],"dehydratedState.queries.3.state.data.15.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.15.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.15.sortTime",[20329],"dehydratedState.queries.3.state.data.15.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.15.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.15.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.15.redirectInfo",[20322],"dehydratedState.queries.3.state.data.16.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.16.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.16.sortTime",[20329],"dehydratedState.queries.3.state.data.16.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.16.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.16.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.16.redirectInfo",[20322],"dehydratedState.queries.3.state.data.17.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.17.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.17.sortTime",[20329],"dehydratedState.queries.3.state.data.17.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.17.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.17.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.17.redirectInfo",[20322],"dehydratedState.queries.3.state.data.18.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.18.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.18.sortTime",[20329],"dehydratedState.queries.3.state.data.18.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.18.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.18.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.18.redirectInfo",[20322],"dehydratedState.queries.3.state.data.19.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.19.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.19.sortTime",[20329],"dehydratedState.queries.3.state.data.19.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.19.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.19.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.19.redirectInfo",[20322],"dehydratedState.queries.3.state.data.20.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.20.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.20.sortTime",[20329],"dehydratedState.queries.3.state.data.20.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.20.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.20.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.20.redirectInfo",[20322],"dehydratedState.queries.3.state.data.21.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.21.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.21.sortTime",[20329],"dehydratedState.queries.3.state.data.21.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.21.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.21.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.21.redirectInfo",[20322],"dehydratedState.queries.3.state.data.22.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.22.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.22.sortTime",[20329],"dehydratedState.queries.3.state.data.22.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.22.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.22.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.22.redirectInfo",[20322],"dehydratedState.queries.3.state.data.23.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.23.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.23.sortTime",[20329],"dehydratedState.queries.3.state.data.23.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.23.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.23.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.23.redirectInfo",[20322],"dehydratedState.queries.3.state.data.24.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.24.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.24.sortTime",[20329],"dehydratedState.queries.3.state.data.24.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.24.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.24.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.24.redirectInfo",[20322],"dehydratedState.queries.3.state.data.25.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.25.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.25.sortTime",[20329],"dehydratedState.queries.3.state.data.25.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.25.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.25.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.25.redirectInfo",[20322],"dehydratedState.queries.3.state.data.26.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.26.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.26.sortTime",[20329],"dehydratedState.queries.3.state.data.26.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.26.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.26.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.26.redirectInfo",[20322],"dehydratedState.queries.3.state.data.27.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.27.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.27.sortTime",[20329],"dehydratedState.queries.3.state.data.27.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.27.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.27.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.27.redirectInfo",[20322],"dehydratedState.queries.3.state.data.28.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.28.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.28.sortTime",[20329],"dehydratedState.queries.3.state.data.28.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.28.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.28.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.28.redirectInfo",[20322],"dehydratedState.queries.3.state.data.29.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.29.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.29.sortTime",[20329],"dehydratedState.queries.3.state.data.29.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.29.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.29.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.29.redirectInfo",[20322],"dehydratedState.queries.3.state.data.30.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.30.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.30.sortTime",[20329],"dehydratedState.queries.3.state.data.30.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.30.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.30.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.30.redirectInfo",[20322],"dehydratedState.queries.3.state.data.31.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.31.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.31.sortTime",[20329],"dehydratedState.queries.3.state.data.31.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.31.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.31.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.31.redirectInfo",[20322],"dehydratedState.queries.3.state.data.32.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.32.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.32.sortTime",[20329],"dehydratedState.queries.3.state.data.32.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.32.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.32.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.32.redirectInfo",[20322],"dehydratedState.queries.3.state.data.33.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.33.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.33.sortTime",[20329],"dehydratedState.queries.3.state.data.33.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.33.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.33.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.33.redirectInfo",[20322],"dehydratedState.queries.3.state.data.34.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.34.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.34.sortTime",[20329],"dehydratedState.queries.3.state.data.34.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.34.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.34.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.34.redirectInfo",[20322],"dehydratedState.queries.3.state.data.35.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.35.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.35.sortTime",[20329],"dehydratedState.queries.3.state.data.35.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.35.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.35.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.35.redirectInfo",[20322],"dehydratedState.queries.3.state.data.36.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.36.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.36.sortTime",[20329],"dehydratedState.queries.3.state.data.36.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.36.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.36.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.36.redirectInfo",[20322],"dehydratedState.queries.3.state.data.37.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.37.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.37.sortTime",[20329],"dehydratedState.queries.3.state.data.37.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.37.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.37.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.37.redirectInfo",[20322],"dehydratedState.queries.3.state.data.38.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.38.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.38.sortTime",[20329],"dehydratedState.queries.3.state.data.38.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.38.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.38.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.38.redirectInfo",[20322],"dehydratedState.queries.3.state.data.39.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.39.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.39.sortTime",[20329],"dehydratedState.queries.3.state.data.39.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.39.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.39.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.39.redirectInfo",[20322],"dehydratedState.queries.3.state.data.40.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.40.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.40.sortTime",[20329],"dehydratedState.queries.3.state.data.40.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.40.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.40.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.40.redirectInfo",[20322],"dehydratedState.queries.3.state.data.41.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.41.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.41.sortTime",[20329],"dehydratedState.queries.3.state.data.41.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.41.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.41.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.41.redirectInfo",[20322],"dehydratedState.queries.3.state.data.42.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.42.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.42.sortTime",[20329],"dehydratedState.queries.3.state.data.42.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.42.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.42.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.42.redirectInfo",[20322],"dehydratedState.queries.3.state.data.43.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.43.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.43.sortTime",[20329],"dehydratedState.queries.3.state.data.43.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.43.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.43.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.43.redirectInfo",[20322],"dehydratedState.queries.3.state.data.44.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.44.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.44.sortTime",[20329],"dehydratedState.queries.3.state.data.44.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.44.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.44.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.44.redirectInfo",[20322],"dehydratedState.queries.3.state.data.45.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.45.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.45.sortTime",[20329],"dehydratedState.queries.3.state.data.45.activitySummary.latestCommentTime.seconds",[20315],"dehydratedState.queries.3.state.data.45.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.45.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.45.redirectInfo",[20322],"dehydratedState.queries.3.state.data.46.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.46.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.46.sortTime",[20329],"dehydratedState.queries.3.state.data.46.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.46.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.46.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.46.redirectInfo",[20322],"dehydratedState.queries.3.state.data.47.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.47.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.47.sortTime",[20329],"dehydratedState.queries.3.state.data.47.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.47.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.47.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.47.redirectInfo",[20322],"dehydratedState.queries.3.state.data.48.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.48.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.48.sortTime",[20329],"dehydratedState.queries.3.state.data.48.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.48.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.48.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.48.redirectInfo",[20322],"dehydratedState.queries.3.state.data.49.createTime.seconds",[20315],"dehydratedState.queries.3.state.data.49.updateTime.seconds",[20315],"dehydratedState.queries.3.state.data.49.sortTime",[20329],"dehydratedState.queries.3.state.data.49.activitySummary.latestCommentTime",[20322],"dehydratedState.queries.3.state.data.49.activitySummary.latestChangeTime.seconds",[20315],"dehydratedState.queries.3.state.data.49.generationInfo.generation",[20315],"dehydratedState.queries.3.state.data.49.redirectInfo",[20322],"dehydratedState.queries.5.state.data.metadata.summary",[20322],"dehydratedState.queries.6.state.data.metadata.summary",[20322],"dehydratedState.queries.7.state.data.metadata.summary",[20322],"dehydratedState.queries.8.state.data.metadata.summary",[20322],"dehydratedState.queries.9.state.data.metadata.summary",[20322],"dehydratedState.queries.10.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.11.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.12.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.13.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.14.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.15.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.16.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.17.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.18.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.19.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.20.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.21.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.22.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.23.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.24.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.25.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.26.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.27.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.28.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.29.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.30.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.31.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.32.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.33.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.34.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.35.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.36.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.37.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.38.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.39.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.40.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.41.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.42.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.43.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.44.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.45.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.46.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.47.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.48.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.49.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.50.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.51.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.52.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.53.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.54.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.55.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.56.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.57.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.58.state.data.document.generationInfo.generation",[20315],"dehydratedState.queries.59.state.data.document.generationInfo.generation",[20315],"referentialEqualities",{"_20313":21682,"_20318":21683,"_20323":21684,"_20340":21685,"_20354":21686,"_20368":21687,"_20382":21688,"_20394":21689,"_20410":21690,"_20424":21691,"_20438":21692,"_20452":21693,"_20464":21694,"_20478":21695,"_20492":21696,"_20506":21697,"_20520":21698,"_20536":21699,"_20550":21700,"_20564":21701,"_20576":21702,"_20592":21703,"_20606":21704,"_20620":21705,"_20634":21706,"_20646":21707,"_20662":21708,"_20676":21709,"_20690":21710,"_20704":21711,"_20716":21712,"_20732":21713,"_20746":21714,"_20760":21715,"_20774":21716,"_20788":21717,"_20800":21718,"_20816":21719,"_20830":21720,"_20844":21721,"_20858":21722,"_20870":21723,"_20880":21724,"_20886":21725,"_20894":21726,"_20900":21727,"_20908":21728,"_20914":21729,"_20922":21730,"_20926":21731,"_20936":21732,"_20940":21733,"_20950":21734,"_20956":21735,"_20964":21736,"_20968":21737,"_20978":21738,"_20982":21739,"_20992":21740,"_20996":21741,"_21006":21742,"_21010":21743,"_21020":21744,"_21026":21745,"_21034":21746,"_21040":21747,"_21048":21748,"_21052":21749,"_21062":21750,"_21068":21751,"_21076":21752,"_21080":21753,"_21090":21754,"_21096":21755,"_21104":21756,"_21110":21757,"_21118":21758,"_21124":21759,"_21132":21760,"_21136":21761,"_21146":21762,"_21150":21763,"_21160":21764,"_21166":21765,"_21174":21766,"_21178":21767,"_21188":21768,"_21192":21769,"_21202":21770,"_21206":21771,"_21216":21772,"_21220":21773,"_21230":21774,"_21236":21775,"_21244":21776,"_21248":21777,"_21258":21778,"_21262":21779,"_21272":21780,"_21276":21781,"_21286":21782,"_21290":21783,"_21300":21784,"_21306":21785,"_21314":21786,"_21320":21787,"_21328":21788,"_21334":21789,"_21342":21790,"_21346":21791,"_21356":21792,"_21360":21793,"_21370":21794,"_21374":21795,"_21384":21796,"_21388":21797,"_21398":21798,"_21402":21799,"_21412":21800,"_21416":21801,"_21426":21802,"_21430":21803,"_21440":21804,"_21444":21805,"_21454":21806,"_21458":21807,"_21468":21808,"_21474":21809,"_21482":21810,"_21488":21811,"_21496":21812,"_21500":21813,"_21510":21814,"_21516":21815,"_21524":21816,"_21528":21817,"_21538":21818,"_21542":21819,"_21552":21820,"_21556":21821,"_21566":21822},[20316,20446],[20362,20450,20684,20796,21038,21066,21108],[20325,20332],[20346],[20360],[20374],[20388],[20396,20402],[20416],[20430],[20444],[20458],[20466,20472],[20480,20486],[20494,20500],[20508,20514],[20522,20528],[20542],[20556],[20570],[20578,20584],[20598],[20612],[20626],[20640],[20648,20654],[20668],[20682],[20696],[20710],[20718,20724],[20738],[20752],[20766],[20780],[20794],[20802,20808],[20822],[20836],[20850],[20864],[20872,20878],[21580],[20892],[21582],[20906],[21590],[20920],[21592],[20928,20934],[21594],[20942,20948],[21596],[20962],[21584],[20970,20976],[21600],[20984,20990],[21588],[20998,21004],[21604],[21012,21018],[21602],[21032],[21586],[21046],[21608],[21054,21060],[21598],[21074],[21610],[21082,21088],[21612],[21102],[21614],[21116],[21620],[21130],[21622],[21138,21144],[21624],[21152,21158],[21626],[21172],[21618],[21180,21186],[21628],[21194,21200],[21630],[21208,21214],[21634],[21222,21228],[21636],[21242],[21640],[21250,21256],[21638],[21264,21270],[21616],[21278,21284],[21632],[21292,21298],[21642],[21312],[21644],[21326],[21646],[21340],[21648],[21348,21354],[21650],[21362,21368],[21652],[21376,21382],[21654],[21390,21396],[21656],[21404,21410],[21658],[21418,21424],[21606],[21432,21438],[21660],[21446,21452],[21662],[21460,21466],[21664],[21480],[21666],[21494],[21668],[21502,21508],[21670],[21522],[21672],[21530,21536],[21674],[21544,21550],[21676],[21558,21564],[21678],"actionData","errors"]