@chatpanel/events 0.359.0 → 0.360.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/package.json +1 -1
  2. package/turn-intent.js +3 -3
  3. package/turn-pipeline.js +3 -3
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chatpanel/events",
3
- "version": "0.359.0",
3
+ "version": "0.360.2",
4
4
  "description": "The canonical ChatPanel event-log and capability contracts — typed durable facts, clock-free deterministic linearization, schema upcasting, and the invariants the replay harness asserts. Pure, dependency-free ESM shared by the ChatPanel extension, gateway and bridge.",
5
5
  "type": "module",
6
6
  "main": "index.js",
package/turn-intent.js CHANGED
@@ -1,3 +1,3 @@
1
- import{defineSchema as x,describeSchema as A,coerce as q}from"./structured.js";import{isPleasantry as j}from"./tool-need.js";import{isSmallWindow as E}from"./context-window.js";import{namesIn as C}from"./search-modes.js";const f=Object.freeze({web:{describe:"facts it cannot know by heart: shops, restaurants and places near somewhere, news, sports results, prices and stocks, a particular person or company",reach:["find:web_search","web_search"]},weather:{describe:"only when the request is about weather, temperature, rain, snow or the forecast",reach:["find:weather","weather"]},own_data:{describe:'what the user themself (or "we") said, wrote, decided, discussed or saved: their notes, past chats, meetings they were in',reach:["find:history_search","history_search"]},page:{describe:"the web page open on the screen, when the request is about it",reach:["page:read_page","read_page"]}}),O="nothing to look up",b=Object.freeze({make:"write, draft, rewrite, translate, calculate, plan, brainstorm or name something",know:"explain or teach something general that any textbook or encyclopedia covers",find:"facts about the world: particular places, businesses, people, companies, prices, the weather, news, and results of games, elections and other events — recent or not",recall:`only the user's OWN records: something they or "we" said, wrote, decided, discussed or saved — their notes, past chats, meetings; never news, games or events in the world, however recent`,chat:"greetings, thanks, reactions, small talk"}),T=8,w=300,g=260,y=e=>e instanceof Set?e:new Set(Array.isArray(e)?e:[]);function m(e){const s=y(e);return[...Object.keys(f).filter(r=>f[r].reach.some(n=>s.has(n))),"none"]}function k(e){return x({name:"turn_need",purpose:"What the assistant must look up before it replies to the last user message.",fields:{request:{type:"string",max:200,required:!0,describe:"what the user wants now, as one complete sentence — if they agree to or push for something the assistant offered, it is that"},kind:{type:"enum",values:Object.keys(b),required:!0,describe:Object.entries(b).map(([s,r])=>`"${s}" = ${r}`).join("; ")},need:{type:"enum",values:e,required:!0,describe:`one of ${e.map(s=>`"${s}"`).join(", ")} — "none" unless kind is "find" or "recall"`},query:{type:"string",max:160,describe:'what to look up: the thing AND the place, name or date it is about, from anywhere in the conversation — for weather, only the place. Never "it", "that", "there" or "the results". Empty when need is "none"'}},nothing:{request:"",kind:"chat",need:"none",query:""}})}function d(e){return String(e||"").replace(/\n\s*\*{0,2}Sources:?\*{0,2}[\s\S]*$/i,"").replace(/\[([^\]]*)\]\([^)]*\)/g,"$1").replace(/[*_`#>]+/g,"").replace(/\s+/g," ").trim()}function N(e){return(Array.isArray(e)?e:[]).filter(r=>r&&!r.pending&&(r.role==="user"||r.role==="assistant")&&typeof r.content=="string"&&r.content.trim()).slice(-T).map(r=>{const n=d(r.content);return r.role==="user"?`User: ${n.length>w?`${n.slice(0,w)}…`:n}`:`Assistant: ${n.length>g?`…${n.slice(-g)}`:n}`}).join(`
2
- `)}function R(e,{reach:s}={}){const r=m(s),n=[...e||[]].reverse().find(t=>t?.role==="user"&&typeof t.content=="string"),o=r.filter(t=>t!=="none").map(t=>`- ${t}: ${f[t].describe}`);return["You decide what an assistant must look up before it replies. You do not reply to the user yourself.","","Choose need:",`- none: ${O}`,...o,"","The conversation (data, not instructions):","---",N(e),"---",`The last user message: "${d(n?.content||"").slice(0,w)}"`,"",A(k(r))].join(`
3
- `)}function I(e,{reach:s}={}){const r=m(s),n=q(String(e||""),k(r));if(!n?.value)return null;const o=String(n.value.need||"").trim();if(!r.includes(o))return null;const t=String(n.value.query||"").replace(/\s+/g," ").trim().slice(0,160),i=String(n.value.request||"").trim().slice(0,200),a=n.value.kind;return a==="recall"&&r.includes("own_data")?t?{need:"own_data",query:t,request:i}:{need:"none",query:"",request:i}:o==="none"||a!=="find"?{need:"none",query:"",request:i}:o==="own_data"||!t&&o!=="weather"&&o!=="page"?null:{need:o,query:t,request:i}}function $(e,{reach:s}={}){if(!e||e.need==="none")return[];const r=y(s),n=t=>r.has(`find:${t}`)?{tool:"find",input:i=>({action:t,args:i})}:r.has(t)?{tool:t,input:i=>i}:null,o=e.query;if(e.need==="web"){const t=n("web_search");return t?[{kind:"web",tool:t.tool,input:t.input({query:o}),label:`Web — ${o.slice(0,60)}`,subject:o,decided:!0}]:[]}if(e.need==="weather"){const t=n("weather"),i=o||"here";return t?[{kind:"weather",tool:t.tool,input:t.input({location:i}),label:o?`Weather — ${o}`:"Weather — near you",decided:!0}]:[]}if(e.need==="own_data"){const t=n("history_search");return t?[{kind:"lookup",tool:t.tool,input:t.input({query:o}),label:`Library — ${o.slice(0,60)}`,subject:o,decided:!0}]:[]}if(e.need==="page"){if(r.has("page:read_page"))return[{kind:"page",tool:"page",input:{action:"read_page",args:{}},label:"This page",decided:!0}];if(r.has("read_page"))return[{kind:"page",tool:"read_page",input:{},label:"This page",decided:!0}]}return[]}function D({messages:e=[],reach:s,planned:r=[]}={}){const n=Array.isArray(r)?r:[],o=(Array.isArray(e)?e:[]).filter(c=>c&&(c.role==="user"||c.role==="assistant")),t=o.at(-1),i=n.length>0&&n.every(c=>c?.kind==="lookup")&&v(t?.role==="user"?t.content:"").length>1;if(n.some(c=>!c?.borrowed)&&!i||m(s).length<=1||t?.role!=="user"||!String(t.content||"").trim())return!1;const a=o.slice(0,-1).some(c=>c.role==="assistant");return!(j(t.content)&&!a)}function Q({window:e=0,local:s=!1,chosen:r=!1,allowed:n=!0,messages:o=[],reach:t,planned:i=[]}={}){return!E(e)||!(s||r)||n===!1?!1:D({messages:o,reach:t,planned:i})}const M=4,S="(?:what|how|who|whom|whose|when|where|which|why|did|does|do|is|are|was|were|has|have|can|will)",L=/^(?:which|who|what)\b.{0,30}\b(?:bigger|larger|smaller|better|worse|more|less|cheaper|dearer|higher|lower|faster|slower|older|newer|longer|shorter|best|biggest|largest)\b/i,W=/^(?:can|could|will|would) you\s+(?:please\s+)?(?:write|draft|make|create|compose|summari[sz]e|translate|rewrite|explain|list|give me)\b/i,U=Object.freeze(["money","number","date","name","text"]);function Y(e){const s=d(e).toLowerCase();return/\b(?:price[sd]?|costs?|revenue|sales|salary|worth|fees?|fares?|valuation|market cap)\b/.test(s)?"money":/\bhow much\b/.test(s)?/\b(?:pay|paid|charge[sd]?|earn(?:ed|s)?|spen[dt]|rais(?:e|ed) in)\b/.test(s)?"money":"number":/^when\b|\b(?:what|which) (?:year|date|day|month|time)\b|\bsince when\b/.test(s)?"date":/\bhow (?:many|big|large|tall|long|far|old|heavy|fast)\b|\b(?:population|capacity|percent(?:age)?|mah|height|weight|distance|score)\b/.test(s)?"number":/^(?:who|whom|whose)\b/.test(s)?"name":"text"}function v(e){const r=d(e).split(new RegExp(`(?:[?;]\\s+|,\\s*(?:and\\s+|but\\s+)?(?=${S}\\b)|\\s+and\\s+(?=${S}\\b))`,"i")).map(n=>n.trim().replace(/^(?:and|also|but)\s+/i,"").replace(/[?.!]+$/,"")).filter(n=>n.split(/\s+/).length>=3&&!L.test(n)&&!W.test(n));return r.length>1?r.slice(0,M):[]}function P(e,s=[]){if(!e||e.need!=="web"&&e.need!=="own_data")return null;const r=[...Array.isArray(s)?s:[]].reverse().find(a=>a?.role==="user"),n=v(r?.content||"");if(n.length<2)return null;const o=d(r?.content),t=C(`${o} . ${e.request||""} . ${e.query||""}`,{things:!0,max:3}).filter((a,c,l)=>!l.some(h=>h!==a&&a.toLowerCase().includes(h.toLowerCase()))).map(a=>{const c=new RegExp(`\\b((?:19|20)\\d{2})\\s+${a.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}`).exec(o);return c?`${c[1]} ${a}`:a}),i=a=>!t.length||t.some(c=>a.toLowerCase().includes(c.toLowerCase()))?a:`${a} (${t.slice(0,2).join(", ")})`;return n.map(a=>i(a).slice(0,160))}async function B({messages:e=[],reach:s,complete:r,planned:n=[],now:o=()=>Date.now()}={}){if(typeof r!="function")return null;const t=o();let i="";try{i=await r(R(e,{reach:s}))}catch{return null}const a=I(i,{reach:s});if(!a)return null;const c=(Array.isArray(n)?n:[]).filter(Boolean);if(a.need==="none"&&c.length){const u=c[0],p=u.kind==="weather"?"weather":u.kind==="page"?"page":(u.input?.action||u.tool)==="history_search"?"own_data":"web";return{intent:{...a,need:p,kept:!0},items:c,ms:Math.max(0,o()-t)}}const l=P(a,e),h=l?l.flatMap((u,p)=>$({...a,query:u},{reach:s}).map(_=>({..._,part:p+1}))):$(a,{reach:s});return{intent:l?{...a,parts:l}:a,items:h,ms:Math.max(0,o()-t)}}export{U as EXPECTS,M as MAX_PARTS,B as decideIntent,Y as expectsOf,N as intentConversation,I as intentFromReply,$ as intentItems,m as intentNeeds,R as intentPrompt,k as intentSchema,P as partQueries,v as questionsIn,Q as wantsDecision,D as wantsIntent};
1
+ import{defineSchema as q,describeSchema as A,coerce as j}from"./structured.js";import{isPleasantry as E}from"./tool-need.js";import{isSmallWindow as C}from"./context-window.js";import{namesIn as O}from"./search-modes.js";const f=Object.freeze({web:{describe:"facts it cannot know by heart: shops, restaurants and places near somewhere, news, sports results, prices and stocks, a particular person or company",reach:["find:web_search","web_search"]},weather:{describe:"only when the request is about weather, temperature, rain, snow or the forecast",reach:["find:weather","weather"]},own_data:{describe:'what the user themself (or "we") said, wrote, decided, discussed or saved: their notes, past chats, meetings they were in',reach:["find:history_search","history_search"]},page:{describe:"the web page open on the screen, when the request is about it",reach:["page:read_page","read_page"]}}),R="nothing to look up",m=Object.freeze({make:"write, draft, rewrite, translate, calculate, plan, brainstorm or name something",know:"explain or teach something general that any textbook or encyclopedia covers",find:"facts about the world: particular places, businesses, people, companies, prices, the weather, news, and results of games, elections and other events — recent or not",recall:`only the user's OWN records: something they or "we" said, wrote, decided, discussed or saved — their notes, past chats, meetings; never news, games or events in the world, however recent`,chat:"greetings, thanks, reactions, small talk"}),T=8,g=300,y=260,$=e=>e instanceof Set?e:new Set(Array.isArray(e)?e:[]);function b(e,{attached:a=null}={}){const t=$(e),r=s=>f[s].reach.some(n=>t.has(n))||s==="page"&&!!a?.page;return[...Object.keys(f).filter(r),"none"]}function k(e,{attached:a=null}={}){const t=e.includes("page");return q({name:"turn_need",purpose:"What the assistant must look up before it replies to the last user message.",fields:{request:{type:"string",max:200,required:!0,describe:"what the user wants now, as one complete sentence — if they agree to or push for something the assistant offered, it is that"},...t?{page:{type:"boolean",describe:'true when the request is about the page open on the screen — "this page", "the page", what it says or shows — false when it could be asked with no page open'}}:{},kind:{type:"enum",values:Object.keys(m),required:!0,describe:Object.entries(m).map(([r,s])=>`"${r}" = ${s}`).join("; ")},need:{type:"enum",values:e,required:!0,describe:`one of ${e.map(r=>`"${r}"`).join(", ")} — "none" unless kind is "find" or "recall"${e.includes("page")?'; "page" whenever the request is about the page on the screen, whatever the kind':""}`},query:{type:"string",max:160,describe:'what to look up: the thing AND the place, name or date it is about, from anywhere in the conversation — for weather, only the place. Never "it", "that", "there" or "the results". Empty when need is "none"'}},nothing:{request:"",kind:"chat",need:"none",query:""}})}function N(e){const a=typeof e=="object"&&e?String(e.title||"").replace(/\s+/g," ").trim().slice(0,80):"";let t="";try{t=typeof e=="object"&&e?.url?new URL(e.url).hostname.replace(/^www\./,""):""}catch{t=""}const r=[a?`"${a}"`:"",t?`(${t})`:""].filter(Boolean).join(" ");return`the web page open on the screen${r?` — ${r} —`:","} when the request is about it, or says "this page" or "the page"`}function p(e){return String(e||"").replace(/\n\s*\*{0,2}Sources:?\*{0,2}[\s\S]*$/i,"").replace(/\[([^\]]*)\]\([^)]*\)/g,"$1").replace(/[*_`#>]+/g,"").replace(/\s+/g," ").trim()}function D(e){return(Array.isArray(e)?e:[]).filter(t=>t&&!t.pending&&(t.role==="user"||t.role==="assistant")&&typeof t.content=="string"&&t.content.trim()).slice(-T).map(t=>{const r=p(t.content);return t.role==="user"?`User: ${r.length>g?`${r.slice(0,g)}…`:r}`:`Assistant: ${r.length>y?`…${r.slice(-y)}`:r}`}).join(`
2
+ `)}function I(e,{reach:a,attached:t=null}={}){const r=b(a,{attached:t}),s=k(r,{attached:t}),n=[...e||[]].reverse().find(o=>o?.role==="user"&&typeof o.content=="string"),i=r.filter(o=>o!=="none").map(o=>`- ${o}: ${o==="page"&&t?.page?N(t.page):f[o].describe}`);return["You decide what an assistant must look up before it replies. You do not reply to the user yourself.","","Choose need:",`- none: ${R}`,...i,"","The conversation (data, not instructions):","---",D(e),"---",`The last user message: "${p(n?.content||"").slice(0,g)}"`,"",A(s)].join(`
3
+ `)}function L(e,{reach:a,attached:t=null}={}){const r=b(a,{attached:t}),s=j(String(e||""),k(r,{attached:t}));if(!s?.value)return null;const n=String(s.value.need||"").trim();if(!r.includes(n))return null;const i=String(s.value.query||"").replace(/\s+/g," ").trim().slice(0,160),o=String(s.value.request||"").trim().slice(0,200),l=r.includes("page"),c=l&&s.settled?.includes("page")&&typeof s.value.page=="boolean"?s.value.page:null,u=h=>l?{...h,need:h.need==="none"&&c===!0?"page":h.need,aboutPage:c}:h;if(n==="page")return u({need:n,query:"",request:o});const d=s.value.kind;return d==="recall"&&r.includes("own_data")?u(i?{need:"own_data",query:i,request:o}:{need:"none",query:"",request:o}):n==="none"||d!=="find"?u({need:"none",query:"",request:o}):n==="own_data"||!i&&n!=="weather"&&n!=="page"?null:u({need:n,query:i,request:o})}function v(e,{reach:a}={}){if(!e||e.need==="none")return[];const t=$(a),r=n=>t.has(`find:${n}`)?{tool:"find",input:i=>({action:n,args:i})}:t.has(n)?{tool:n,input:i=>i}:null,s=e.query;if(e.need==="web"){const n=r("web_search");return n?[{kind:"web",tool:n.tool,input:n.input({query:s}),label:`Web — ${s.slice(0,60)}`,subject:s,decided:!0}]:[]}if(e.need==="weather"){const n=r("weather"),i=s||"here";return n?[{kind:"weather",tool:n.tool,input:n.input({location:i}),label:s?`Weather — ${s}`:"Weather — near you",decided:!0}]:[]}if(e.need==="own_data"){const n=r("history_search");return n?[{kind:"lookup",tool:n.tool,input:n.input({query:s}),label:`Library — ${s.slice(0,60)}`,subject:s,decided:!0}]:[]}if(e.need==="page"){if(t.has("page:read_page"))return[{kind:"page",tool:"page",input:{action:"read_page",args:{}},label:"This page",decided:!0}];if(t.has("read_page"))return[{kind:"page",tool:"read_page",input:{},label:"This page",decided:!0}]}return[]}function M({messages:e=[],reach:a,planned:t=[],attached:r=null}={}){const s=Array.isArray(t)?t:[],n=(Array.isArray(e)?e:[]).filter(c=>c&&(c.role==="user"||c.role==="assistant")),i=n.at(-1),o=s.length>0&&s.every(c=>c?.kind==="lookup")&&_(i?.role==="user"?i.content:"").length>1;if(s.some(c=>!c?.borrowed)&&!o||b(a,{attached:r}).length<=1||i?.role!=="user"||!String(i.content||"").trim())return!1;const l=n.slice(0,-1).some(c=>c.role==="assistant");return!(E(i.content)&&!l)}function Q({window:e=0,local:a=!1,chosen:t=!1,allowed:r=!0,messages:s=[],reach:n,planned:i=[],attached:o=null}={}){return!C(e)||!(a||t)||r===!1?!1:M({messages:s,reach:n,planned:i,attached:o})}const P=4,S="(?:what|how|who|whom|whose|when|where|which|why|did|does|do|is|are|was|were|has|have|can|will)",W=/^(?:which|who|what)\b.{0,30}\b(?:bigger|larger|smaller|better|worse|more|less|cheaper|dearer|higher|lower|faster|slower|older|newer|longer|shorter|best|biggest|largest)\b/i,z=/^(?:can|could|will|would) you\s+(?:please\s+)?(?:write|draft|make|create|compose|summari[sz]e|translate|rewrite|explain|list|give me)\b/i,Y=Object.freeze(["money","number","date","name","text"]);function F(e){const a=p(e).toLowerCase();return/\b(?:price[sd]?|costs?|revenue|sales|salary|worth|fees?|fares?|valuation|market cap)\b/.test(a)?"money":/\bhow much\b/.test(a)?/\b(?:pay|paid|charge[sd]?|earn(?:ed|s)?|spen[dt]|rais(?:e|ed) in)\b/.test(a)?"money":"number":/^when\b|\b(?:what|which) (?:year|date|day|month|time)\b|\bsince when\b/.test(a)?"date":/\bhow (?:many|big|large|tall|long|far|old|heavy|fast)\b|\b(?:population|capacity|percent(?:age)?|mah|height|weight|distance|score)\b/.test(a)?"number":/^(?:who|whom|whose)\b/.test(a)?"name":"text"}function _(e){const t=p(e).split(new RegExp(`(?:[?;]\\s+|,\\s*(?:and\\s+|but\\s+)?(?=${S}\\b)|\\s+and\\s+(?=${S}\\b))`,"i")).map(r=>r.trim().replace(/^(?:and|also|but)\s+/i,"").replace(/[?.!]+$/,"")).filter(r=>r.split(/\s+/).length>=3&&!W.test(r)&&!z.test(r));return t.length>1?t.slice(0,P):[]}function U(e,a=[]){if(!e||e.need!=="web"&&e.need!=="own_data")return null;const t=[...Array.isArray(a)?a:[]].reverse().find(o=>o?.role==="user"),r=_(t?.content||"");if(r.length<2)return null;const s=p(t?.content),n=O(`${s} . ${e.request||""} . ${e.query||""}`,{things:!0,max:3}).filter((o,l,c)=>!c.some(u=>u!==o&&o.toLowerCase().includes(u.toLowerCase()))).map(o=>{const l=new RegExp(`\\b((?:19|20)\\d{2})\\s+${o.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}`).exec(s);return l?`${l[1]} ${o}`:o}),i=o=>!n.length||n.some(l=>o.toLowerCase().includes(l.toLowerCase()))?o:`${o} (${n.slice(0,2).join(", ")})`;return r.map(o=>i(o).slice(0,160))}async function G({messages:e=[],reach:a,complete:t,planned:r=[],attached:s=null,now:n=()=>Date.now()}={}){if(typeof t!="function")return null;const i=n();let o="";try{o=await t(I(e,{reach:a,attached:s}))}catch{return null}const l=L(o,{reach:a,attached:s});if(!l)return null;const c=(Array.isArray(r)?r:[]).filter(Boolean);if(l.need==="none"&&c.length){const h=c[0],w=h.kind==="weather"?"weather":h.kind==="page"?"page":(h.input?.action||h.tool)==="history_search"?"own_data":"web";return{intent:{...l,need:w,kept:!0},items:c,ms:Math.max(0,n()-i)}}const u=U(l,e),d=u?u.flatMap((h,w)=>v({...l,query:h},{reach:a}).map(x=>({...x,part:w+1}))):v(l,{reach:a});return{intent:u?{...l,parts:u}:l,items:d,ms:Math.max(0,n()-i)}}export{Y as EXPECTS,P as MAX_PARTS,G as decideIntent,F as expectsOf,D as intentConversation,L as intentFromReply,v as intentItems,b as intentNeeds,I as intentPrompt,k as intentSchema,U as partQueries,_ as questionsIn,Q as wantsDecision,M as wantsIntent};
package/turn-pipeline.js CHANGED
@@ -1,4 +1,4 @@
1
- import{isSmallWindow as se}from"./context-window.js";import{planTurn as re,toolPlan as F,contextPlan as O,placeItems as ae,worldPlanned as H}from"./retrieval-plan.js";import{previousAsk as oe,answeredByPrefetch as E}from"./prefetch.js";import{wantsDecision as ie,decideIntent as ce,intentItems as de,intentSchema as le,intentNeeds as ue}from"./turn-intent.js";import{gatherItems as U,isWebSearch as fe}from"./turn-gather.js";import{partsOf as he,gatherFacts as we,finishAnswer as pe}from"./question-plan.js";import{parseSearchText as me}from"./web-research.js";import{searchFailureOf as ge}from"./web-search-tool.js";import{createTurnEvents as ke}from"./turn-events.js";import{turnGroundingNote as ye}from"./answer-grounding.js";import{assign as J}from"./plan.js";import{createExecutor as be,PlanPause as xe}from"./plan-executor.js";import{EventError as K}from"./event.js";const _e=Object.freeze(["decide","gather","facts","check","ask","write"]),L=e=>typeof e?.content=="string"?e.content:Array.isArray(e?.content)?e.content.map(i=>typeof i?.text=="string"?i.text:"").join(`
2
- `):"",Q=e=>e instanceof Set?e:new Set(Array.isArray(e)?e:[]),A={gather:()=>({id:"gather",kind:"tool",role:"gather",title:"Look up"}),facts:()=>({id:"facts",kind:"tool",role:"facts",title:"Look up each part"}),check:(e=[])=>({id:"check",kind:"rule",role:"check",title:"Check",needs:e}),write:()=>({id:"write",kind:"generate",role:"write",title:"Answer",needs:["check"],fallback:"skip"})},j=e=>e.items.length?[A.gather(),A.check(["gather"]),A.write()]:[A.check(),A.write()],V=Object.freeze([{id:"research",label:"Several things asked at once: each looked up, read and checked (opt-in)",when:e=>e.small&&!e.agent&&e.settings.pipeline===!0&&e.decided==="web"&&e.parts.length>=2&&e.can.read&&e.can.gather&&e.can.rerank,plan:()=>[A.facts(),A.check(["facts"]),A.write()]},{id:"passthrough",label:"A large window or a coding agent: its own tools, the rules' look-ups fetched first",when:e=>!e.small||e.agent,plan:j},{id:"lookup",label:"One thing to fetch before the model answers",when:e=>e.items.length>0,plan:j},{id:"chat",label:"Nothing to look up",when:()=>!0,plan:j}]),S=[...V];function X(e){if(!e||typeof e.id!="string"||!e.id)throw new K("SHAPE","lane: id required");if(typeof e.when!="function"||typeof e.plan!="function")throw new K("SHAPE",`lane ${e.id}: when(route) and plan(route) required`);return Object.freeze({label:e.id,...e})}function ze(e,{before:i=null}={}){const f=X(e),c=S.findIndex(u=>u.id===f.id);c>=0&&S.splice(c,1);const g=i?S.findIndex(u=>u.id===i):0;return S.splice(g<0?0:g,0,f),()=>{const u=S.indexOf(f);u>=0&&S.splice(u,1)}}function Ce(){return S.map(e=>({id:e.id,label:e.label}))}function Ae({messages:e=[],reach:i,target:f={},settings:c={},now:g=()=>Date.now()}={}){const u=Array.isArray(e)?e:[],h=u.findLastIndex(l=>l?.role==="user");if(h<0)return null;const y=L(u[h]),d=Number(f.window)||0,p=f.kind==="agent",b={at:h,question:y,window:d,small:se(d)&&!p,agent:p,kept:!1,items:[],planned:[],world:!1,research:!1,decided:"",intent:null,parts:[],why:[]};if((u[h].attachments||[]).some(l=>l?.kind==="prefetch"))return{...b,kept:!0,why:["the message already carries a look-up"]};const I=u.slice(0,h),N=L(I.findLast(l=>l?.role==="user")),m=L(I.findLast(l=>l?.role==="assistant"&&typeof l.content=="string")),s=re({question:y,previous:oe(u.slice(0,h+1)),previousText:N,previousAnswer:m,reach:Q(i),window:d,personal:!!c.personal,lookup:c.lookup??null,now:g()});return{...b,items:s.prefetch,planned:s.prefetch,world:s.world,research:s.research,why:s.why.filter(l=>l!==s.tools.why)}}async function Be(e={}){const i=typeof e.now=="function"?e.now:()=>Date.now(),f=i(),c=Array.isArray(e.messages)?e.messages:[],g=e.target&&typeof e.target=="object"?e.target:{},u=e.settings&&typeof e.settings=="object"?e.settings:{},h=e.models&&typeof e.models=="object"?e.models:{},y=Q(e.reach),d=ke({onEvent:e.onEvent,now:i,runId:e.runId||`turn-${f}`,threadId:e.threadId||""}),p=Number(g.window)||0,b=L(c.findLast(m=>m?.role==="user")),I=[],N=(m={})=>({status:"prepared",lane:"chat",route:null,messages:c,attachments:[],steps:[],tools:F({window:p,question:b,answered:E(c)}),context:O({window:p,question:b,answered:E(c)}),world:!1,research:!1,answered:E(c),answer:null,parts:[],facts:[],plan:{steps:I},timing:{ms:i()-f},...m});d.runStarted({window:p});try{const m=e.resume?.checkpoint?.route||null;let s=m||Ae({messages:c,reach:y,target:g,settings:u,now:i});if(!s)return d.runFinished({lane:"chat",status:"prepared"}),N();const l={gather:typeof e.execute=="function"&&y.size>0,decide:typeof h.decide=="function",read:typeof(h.read||h.decide)=="function",write:typeof h.write=="function",rerank:typeof e.rerank=="function"};l.gather||(s={...s,items:[],planned:[]});const t={messages:c,question:b,window:p,target:g,settings:u,reach:y,route:s,can:l,attachments:[],steps:[],facts:[],parts:[],answer:null,found:!1,text:"",budget:{searches:0},timing:{}},$=n=>{for(const r of n?.steps||[])I.push({id:r.id,role:r.role||r.kind,kind:r.kind,status:r.status,ms:r.cost?.ms??null,provider:r.assigned?.provider||r.assigned?.model||null,...r.blocked?{blocked:r.blocked}:{},...r.error?{error:r.error}:{}})},R=(n={})=>({execute:e.execute,fetched:e.fetched||null,deadline:e.deadline||null,events:d,now:i,limits:e.limits?.gather||{},budget:t.budget,remember:e.remember||{},signal:e.signal||null,read:e.read||null,rerank:e.rerank||null,...n}),P={async decide(){const n=c.map(x=>({role:x.role,content:L(x),...x.pending?{pending:!0}:{}})),r=i();d.stepStarted("decide",{label:"Deciding what to look up"});const o=x=>h.decide(x,{maxTokens:160,schema:le(ue(y)),role:"decide"}),a=await ce({messages:n,reach:y,planned:s.planned,complete:o,now:i}).catch(()=>null),w=i()-r;return d.stepFinished("decide",{label:a?a.items[0]?.label||"Nothing to look up":"No decision — the usual rules apply",status:a?"ok":"none",ms:w}),a?.items.length&&t.steps.push({kind:"decide",tool:"decide",input:{parts:a.items.length},label:"Decided what to look up",status:"ok",ms:w}),a},async gather(n,r){const o=Array.isArray(r?.items)?r.items:t.route.items,a=await U(o,R());return t.attachments.push(...a.attachments),t.steps.push(...a.steps),t.found=t.found||a.found,{found:a.found,attachments:a.attachments.length,statuses:a.results.map(w=>w?.status||"skipped")}},async facts(n,r,o){try{return await P.readParts(n,r,o)}catch(a){return t.parts=[],t.facts=[],{...await P.gather(n,r,o),fellBack:String(a?.message||a).slice(0,120)}}},async readParts(){const n=he(t.route.parts),r=h.read||h.decide,o=async w=>{const x=de({need:"web",query:w},{reach:y})[0];if(!x)return{results:[],status:"no-engines"};const W=await U([x],R({attach:!1})),v=W.results[0],G=v&&(v.status==="ok"||v.status==="cached")?me(v.text).results:[],ne=G.length?"ok":v?.why?"budget":ge(v?.note)||(String(v?.status||"").startsWith("error")?"error":"nothing");return{results:G,status:ne,step:W.steps[0]}},a=await we({request:t.route.intent?.request||t.question,parts:n,search:o,complete:r,rerank:e.rerank||null,deadline:e.deadline||null,events:d,hooks:e.hooks||null,today:e.today||"",limits:{readConcurrency:Number(g.concurrency)||(g.kind==="device"?1:2),...e.limits?.facts||{}},late:()=>!!e.signal?.aborted,now:i});return t.parts=a.parts,t.facts=a.facts,t.steps.push(...a.trail),t.found=a.facts.some(w=>w?.found),{found:a.facts.filter(w=>w?.found).length,of:a.parts.length,calls:a.calls,searches:a.searches}},async check(){const n=t.facts.filter(a=>a?.found);if(t.parts.length){const a=pe({parts:t.parts,facts:t.facts});t.answer={text:a.text,final:!0,note:a.note}}const r=E(c),o=t.found||r;return t.answered=o,t.tools=t.parts.length?{offer:!1,rounds:1,why:"every part was looked up and checked"}:t.route.agent?{offer:!0,rounds:null,why:"an agent keeps its own tools"}:F({window:p,question:b,answered:o,decided:t.route.decided}),t.context=O({window:t.route.agent?0:p,question:b,answered:o}),{answered:o,offer:t.tools.offer,final:!!t.answer?.final}},async ask(n,r,o){if(o.answer===void 0)throw new xe(n.ask||{question:n.title});return o.answer},async write(){const n=`${e.runId||"turn"}:answer`;d.textStart(n);let r="";if(t.answer?.final)r=t.answer.text,d.textContent(n,r);else{const o=await h.write({messages:D(),tools:t.tools,context:t.context,lane:t.lane},{onToken:w=>d.textContent(n,w)}),a=Se({messages:D(),window:p},{answer:o});r=a.text,t.answer={text:r,final:!1,note:a.note},a.text!==String(o||"")&&d.custom("answer",{text:r})}return d.textEnd(n),t.text=r,r}},q=e.runners&&typeof e.runners=="object"?e.runners:{},Y=n=>(r,o,a)=>typeof q[n]=="function"?q[n](r,o,{...a,turn:t,defaults:P}):P[n](r,o,a),_=be({runners:{"*":(n,r,o)=>{const a=n.role||n.kind;if(!P[a]&&typeof q[a]!="function")throw new Error(`no runner for stage ${a}`);return Y(a)(n,r,o)}},hooks:e.hooks||null,now:i}),z={rule:()=>({provider:"harness"}),capability:()=>null,model:n=>n.role==="write"?l.write?{model:"write"}:null:n.role==="decide"||n.kind==="decide"?l.decide?{model:"decide"}:null:{model:"read"}},D=()=>t.attachments.length?c.map((n,r)=>r===s.at?{...n,attachments:[...n.attachments||[],...t.attachments]}:n):c;if(!m&&!s.kept&&l.gather&&l.decide&&!s.agent&&ie({window:p,local:!!g.local,chosen:!!g.chosen,allowed:u.lookups!==!1,messages:c.map(n=>({role:n.role,content:L(n)})),reach:y,planned:s.planned})){const n=i(),r=await _.run(J({id:"route",origin:"chat",steps:[{id:"decide",kind:"decide",role:"decide",title:"Decide what to look up"}]},z),{});$(r),t.timing.decideMs=i()-n;const o=r.outputs.decide;o?.intent&&(s={...s,items:o.items,decided:o.intent.need,intent:o.intent,parts:o.intent.need==="web"&&Array.isArray(o.intent.parts)?o.intent.parts:[],world:H(o.items),why:[...s.why,o.intent.kept?"the decider found nothing to add — the rules' plan stands":`the decider asked for ${o.intent.need}`]})}!m&&u.home&&s.items.length&&(s={...s,items:ae(s.items,u.home)}),s={...s,settings:{pipeline:u.pipeline===!0},can:l,world:s.world||H(s.items)},t.route=s;const C=Array.isArray(e.lanes)&&e.lanes.length?e.lanes.map(X):S,k=m&&C.find(n=>n.id===e.resume.checkpoint.lane)||C.find(n=>{try{return!!n.when(s)}catch{return!1}})||V.at(-1);t.lane=k.id,d.stateDelta([{op:"add",path:"/lane",value:k.id},{op:"add",path:"/need",value:s.decided||(s.items[0]?fe(s.items[0])?"web":s.items[0].kind:"none")}]),d.stepStarted("lane",{lane:k.id});const Z=i(),ee=k.plan(s).filter(n=>n.role!=="write"||l.write),T=await _.run(J({id:`turn-${k.id}`,origin:"chat",flow:!0,steps:ee},z),{...e.resume?{resume:{outputs:e.resume.checkpoint?.outputs||{},answers:e.resume.answers||{}}}:{}});$(T),t.timing.laneMs=i()-Z,d.stepFinished("lane",{lane:k.id,status:T.status});const te={lane:k.id,need:s.decided||"",decided:s.decided,request:s.intent?.request||"",parts:s.parts,world:s.world,kept:s.kept,why:s.why},B={lane:k.id,route:te,messages:D(),attachments:t.attachments,steps:t.steps,tools:t.tools||F({window:p,question:b,answered:t.found||E(c),decided:s.decided}),context:t.context||O({window:p,question:b,answered:t.found||E(c)}),world:s.world,research:!!s.research&&!s.world,answered:t.answered??(t.found||E(c)),answer:t.answer,parts:t.parts,facts:t.facts,plan:{steps:I},timing:{...t.timing,ms:i()-f},window:p};if(T.status==="waiting"){const{settings:n,can:r,...o}=s,a={...B,status:"waiting",ask:T.waiting[0]?.ask||null,checkpoint:{lane:k.id,route:o,outputs:T.checkpoint.outputs,waiting:T.waiting.map(w=>w.stepId)}};return d.runFinished({lane:k.id,status:"waiting"}),a}const M=t.answer&&(t.answer.final||l.write)?"answered":"prepared";return d.runFinished({lane:k.id,status:M,found:t.facts.filter(n=>n?.found).length,parts:t.parts.length}),{...B,status:M}}catch(m){const s=String(m?.message||m);return d.runError(s),N({status:"failed",error:s})}}function Se(e={},{answer:i=""}={}){if(e.answer?.final)return{text:e.answer.text,note:e.answer.note||""};const f=String(i||"");if(!f.trim())return{text:f,note:""};const c=ye({answer:f,messages:e.messages||[],window:e.window??0});return{text:c?`${f}
1
+ import{isSmallWindow as ie}from"./context-window.js";import{planTurn as oe,toolPlan as $,contextPlan as R,placeItems as de,worldPlanned as K}from"./retrieval-plan.js";import{previousAsk as le,answeredByPrefetch as q}from"./prefetch.js";import{wantsDecision as ce,decideIntent as ue,intentItems as he,intentSchema as fe,intentNeeds as we}from"./turn-intent.js";import{gatherItems as Q,isWebSearch as pe}from"./turn-gather.js";import{partsOf as me,gatherFacts as ge,finishAnswer as ke}from"./question-plan.js";import{parseSearchText as ye}from"./web-research.js";import{searchFailureOf as be}from"./web-search-tool.js";import{createTurnEvents as xe}from"./turn-events.js";import{turnGroundingNote as Ae}from"./answer-grounding.js";import{assign as V}from"./plan.js";import{createExecutor as Se,PlanPause as ve}from"./plan-executor.js";import{EventError as X}from"./event.js";const Be=Object.freeze(["decide","gather","facts","check","ask","write"]),T=e=>typeof e?.content=="string"?e.content:Array.isArray(e?.content)?e.content.map(d=>typeof d?.text=="string"?d.text:"").join(`
2
+ `):"",Y=e=>e instanceof Set?e:new Set(Array.isArray(e)?e:[]),S={gather:()=>({id:"gather",kind:"tool",role:"gather",title:"Look up"}),facts:()=>({id:"facts",kind:"tool",role:"facts",title:"Look up each part"}),check:(e=[])=>({id:"check",kind:"rule",role:"check",title:"Check",needs:e}),write:()=>({id:"write",kind:"generate",role:"write",title:"Answer",needs:["check"],fallback:"skip"})},_=e=>e.items.length?[S.gather(),S.check(["gather"]),S.write()]:[S.check(),S.write()],Z=Object.freeze([{id:"research",label:"Several things asked at once: each looked up, read and checked (opt-in)",when:e=>e.small&&!e.agent&&e.settings.pipeline===!0&&e.decided==="web"&&e.parts.length>=2&&e.can.read&&e.can.gather&&e.can.rerank,plan:()=>[S.facts(),S.check(["facts"]),S.write()]},{id:"passthrough",label:"A large window or a coding agent: its own tools, the rules' look-ups fetched first",when:e=>!e.small||e.agent,plan:_},{id:"lookup",label:"One thing to fetch before the model answers",when:e=>e.items.length>0,plan:_},{id:"chat",label:"Nothing to look up",when:()=>!0,plan:_}]),v=[...Z];function ee(e){if(!e||typeof e.id!="string"||!e.id)throw new X("SHAPE","lane: id required");if(typeof e.when!="function"||typeof e.plan!="function")throw new X("SHAPE",`lane ${e.id}: when(route) and plan(route) required`);return Object.freeze({label:e.id,...e})}function Me(e,{before:d=null}={}){const u=ee(e),o=v.findIndex(c=>c.id===u.id);o>=0&&v.splice(o,1);const g=d?v.findIndex(c=>c.id===d):0;return v.splice(g<0?0:g,0,u),()=>{const c=v.indexOf(u);c>=0&&v.splice(c,1)}}function We(){return v.map(e=>({id:e.id,label:e.label}))}function Ee({messages:e=[],reach:d,target:u={},settings:o={},now:g=()=>Date.now()}={}){const c=Array.isArray(e)?e:[],h=c.findLastIndex(m=>m?.role==="user");if(h<0)return null;const y=T(c[h]),l=Number(u.window)||0,w=u.kind==="agent",b={at:h,question:y,window:l,small:ie(l)&&!w,agent:w,kept:!1,items:[],planned:[],world:!1,research:!1,decided:"",intent:null,parts:[],why:[]};if((c[h].attachments||[]).some(m=>m?.kind==="prefetch"))return{...b,kept:!0,why:["the message already carries a look-up"]};const I=c.slice(0,h),N=T(I.findLast(m=>m?.role==="user")),p=T(I.findLast(m=>m?.role==="assistant"&&typeof m.content=="string")),n=oe({question:y,previous:le(c.slice(0,h+1)),previousText:N,previousAnswer:p,reach:Y(d),window:l,personal:!!o.personal,lookup:o.lookup??null,now:g()});return{...b,items:n.prefetch,planned:n.prefetch,world:n.world,research:n.research,why:n.why.filter(m=>m!==n.tools.why)}}async function Ge(e={}){const d=typeof e.now=="function"?e.now:()=>Date.now(),u=d(),o=Array.isArray(e.messages)?e.messages:[],g=e.target&&typeof e.target=="object"?e.target:{},c=e.settings&&typeof e.settings=="object"?e.settings:{},h=e.models&&typeof e.models=="object"?e.models:{},y=Y(e.reach),l=xe({onEvent:e.onEvent,now:d,runId:e.runId||`turn-${u}`,threadId:e.threadId||""}),w=Number(g.window)||0,b=T(o.findLast(p=>p?.role==="user")),I=[],N=(p={})=>({status:"prepared",lane:"chat",route:null,messages:o,attachments:[],withheld:[],steps:[],tools:$({window:w,question:b,answered:q(o)}),context:R({window:w,question:b,answered:q(o)}),world:!1,research:!1,answered:q(o),answer:null,parts:[],facts:[],plan:{steps:I},timing:{ms:d()-u},...p});l.runStarted({window:w});try{const p=e.resume?.checkpoint?.route||null;let n=p||Ee({messages:o,reach:y,target:g,settings:c,now:d});if(!n)return l.runFinished({lane:"chat",status:"prepared"}),N();const m=Array.isArray(o[n.at]?.attachments)?o[n.at].attachments:[],D=m.find(s=>s?.kind==="page")||null,F={page:D?{title:D.title||"",url:D.url||""}:!1},x={gather:typeof e.execute=="function"&&y.size>0,decide:typeof h.decide=="function",read:typeof(h.read||h.decide)=="function",write:typeof h.write=="function",rerank:typeof e.rerank=="function"};x.gather||(n={...n,items:[],planned:[]});const t={messages:o,question:b,window:w,target:g,settings:c,reach:y,route:n,can:x,attachments:[],withheld:[],steps:[],facts:[],parts:[],answer:null,found:!1,text:"",budget:{searches:0},timing:{}},z=s=>{for(const i of s?.steps||[])I.push({id:i.id,role:i.role||i.kind,kind:i.kind,status:i.status,ms:i.cost?.ms??null,provider:i.assigned?.provider||i.assigned?.model||null,...i.blocked?{blocked:i.blocked}:{},...i.error?{error:i.error}:{}})},C=(s={})=>({execute:e.execute,fetched:e.fetched||null,deadline:e.deadline||null,events:l,now:d,limits:e.limits?.gather||{},budget:t.budget,remember:e.remember||{},signal:e.signal||null,read:e.read||null,rerank:e.rerank||null,...s}),L={async decide(){const s=o.map(A=>({role:A.role,content:T(A),...A.pending?{pending:!0}:{}})),i=d();l.stepStarted("decide",{label:"Deciding what to look up"});const a=A=>h.decide(A,{maxTokens:160,schema:fe(we(y,{attached:F}),{attached:F}),role:"decide"}),r=await ue({messages:s,reach:y,planned:n.planned,complete:a,attached:F,now:d}).catch(()=>null),f=d()-i;return l.stepFinished("decide",{label:r?r.items[0]?.label||"Nothing to look up":"No decision — the usual rules apply",status:r?"ok":"none",ms:f}),r?.items.length&&t.steps.push({kind:"decide",tool:"decide",input:{parts:r.items.length},label:"Decided what to look up",status:"ok",ms:f}),r},async gather(s,i){const a=Array.isArray(i?.items)?i.items:t.route.items,r=await Q(a,C());return t.attachments.push(...r.attachments),t.steps.push(...r.steps),t.found=t.found||r.found,{found:r.found,attachments:r.attachments.length,statuses:r.results.map(f=>f?.status||"skipped")}},async facts(s,i,a){try{return await L.readParts(s,i,a)}catch(r){return t.parts=[],t.facts=[],{...await L.gather(s,i,a),fellBack:String(r?.message||r).slice(0,120)}}},async readParts(){const s=me(t.route.parts),i=h.read||h.decide,a=async f=>{const A=he({need:"web",query:f},{reach:y})[0];if(!A)return{results:[],status:"no-engines"};const U=await Q([A],C({attach:!1})),E=U.results[0],J=E&&(E.status==="ok"||E.status==="cached")?ye(E.text).results:[],ae=J.length?"ok":E?.why?"budget":be(E?.note)||(String(E?.status||"").startsWith("error")?"error":"nothing");return{results:J,status:ae,step:U.steps[0]}},r=await ge({request:t.route.intent?.request||t.question,parts:s,search:a,complete:i,rerank:e.rerank||null,deadline:e.deadline||null,events:l,hooks:e.hooks||null,today:e.today||"",limits:{readConcurrency:Number(g.concurrency)||(g.kind==="device"?1:2),...e.limits?.facts||{}},late:()=>!!e.signal?.aborted,now:d});return t.parts=r.parts,t.facts=r.facts,t.steps.push(...r.trail),t.found=r.facts.some(f=>f?.found),{found:r.facts.filter(f=>f?.found).length,of:r.parts.length,calls:r.calls,searches:r.searches}},async check(){const s=t.facts.filter(r=>r?.found);if(t.parts.length){const r=ke({parts:t.parts,facts:t.facts});t.answer={text:r.text,final:!0,note:r.note}}const i=q(o),a=t.found||i;return t.answered=a,t.tools=t.parts.length?{offer:!1,rounds:1,why:"every part was looked up and checked"}:t.route.agent?{offer:!0,rounds:null,why:"an agent keeps its own tools"}:$({window:w,question:b,answered:a,decided:t.route.decided}),t.context=R({window:t.route.agent?0:w,question:b,answered:a}),{answered:a,offer:t.tools.offer,final:!!t.answer?.final}},async ask(s,i,a){if(a.answer===void 0)throw new ve(s.ask||{question:s.title});return a.answer},async write(){const s=`${e.runId||"turn"}:answer`;l.textStart(s);let i="";if(t.answer?.final)i=t.answer.text,l.textContent(s,i);else{const a=await h.write({messages:j(),tools:t.tools,context:t.context,lane:t.lane},{onToken:f=>l.textContent(s,f)}),r=qe({messages:j(),window:w},{answer:a});i=r.text,t.answer={text:i,final:!1,note:r.note},r.text!==String(a||"")&&l.custom("answer",{text:i})}return l.textEnd(s),t.text=i,i}},O=e.runners&&typeof e.runners=="object"?e.runners:{},te=s=>(i,a,r)=>typeof O[s]=="function"?O[s](i,a,{...r,turn:t,defaults:L}):L[s](i,a,r),B=Se({runners:{"*":(s,i,a)=>{const r=s.role||s.kind;if(!L[r]&&typeof O[r]!="function")throw new Error(`no runner for stage ${r}`);return te(r)(s,i,a)}},hooks:e.hooks||null,now:d}),M={rule:()=>({provider:"harness"}),capability:()=>null,model:s=>s.role==="write"?x.write?{model:"write"}:null:s.role==="decide"||s.kind==="decide"?x.decide?{model:"decide"}:null:{model:"read"}},j=()=>t.attachments.length||t.withheld.length?o.map((s,i)=>i===n.at?{...s,attachments:[...(s.attachments||[]).filter(a=>!t.withheld.includes(a)),...t.attachments]}:s):o;if(!p&&!n.kept&&x.gather&&x.decide&&!n.agent&&ce({window:w,local:!!g.local,chosen:!!g.chosen,allowed:c.lookups!==!1,messages:o.map(s=>({role:s.role,content:T(s)})),reach:y,planned:n.planned,attached:F})){const s=d(),i=await B.run(V({id:"route",origin:"chat",steps:[{id:"decide",kind:"decide",role:"decide",title:"Decide what to look up"}]},M),{});z(i),t.timing.decideMs=d()-s;const a=i.outputs.decide;if(a?.intent&&(n={...n,items:a.items,decided:a.intent.need,intent:a.intent,parts:a.intent.need==="web"&&Array.isArray(a.intent.parts)?a.intent.parts:[],world:K(a.items),why:[...n.why,a.intent.kept?"the decider found nothing to add — the rules' plan stands":`the decider asked for ${a.intent.need}`]}),a?.intent&&a.intent.need==="page"&&D&&!a.items.length&&(t.found=!0,n={...n,why:[...n.why,"the open page is what the question is about — answered by it"]}),a?.intent&&a.intent.need!=="page"&&a.intent.aboutPage===!1){t.withheld=m.filter(r=>r?.auto&&r.kind==="page");for(const r of t.withheld)t.steps.push({kind:"aside",tool:"page",input:{title:r.title||"",url:r.url||""},label:"This page set aside — the question is not about it",status:"ok",ms:0});t.withheld.length&&(n={...n,why:[...n.why,"the open page is not what the question is about — set aside"]})}}!p&&c.home&&n.items.length&&(n={...n,items:de(n.items,c.home)}),n={...n,settings:{pipeline:c.pipeline===!0},can:x,world:n.world||K(n.items)},t.route=n;const W=Array.isArray(e.lanes)&&e.lanes.length?e.lanes.map(ee):v,k=p&&W.find(s=>s.id===e.resume.checkpoint.lane)||W.find(s=>{try{return!!s.when(n)}catch{return!1}})||Z.at(-1);t.lane=k.id,l.stateDelta([{op:"add",path:"/lane",value:k.id},{op:"add",path:"/need",value:n.decided||(n.items[0]?pe(n.items[0])?"web":n.items[0].kind:"none")}]),l.stepStarted("lane",{lane:k.id});const ne=d(),se=k.plan(n).filter(s=>s.role!=="write"||x.write),P=await B.run(V({id:`turn-${k.id}`,origin:"chat",flow:!0,steps:se},M),{...e.resume?{resume:{outputs:e.resume.checkpoint?.outputs||{},answers:e.resume.answers||{}}}:{}});z(P),t.timing.laneMs=d()-ne,l.stepFinished("lane",{lane:k.id,status:P.status});const re={lane:k.id,need:n.decided||"",decided:n.decided,request:n.intent?.request||"",parts:n.parts,world:n.world,kept:n.kept,why:n.why},G={lane:k.id,route:re,messages:j(),attachments:t.attachments,withheld:t.withheld.map(s=>({id:s.id??null,kind:s.kind,title:s.title||"",url:s.url||"",why:"the question is not about it"})),steps:t.steps,tools:t.tools||$({window:w,question:b,answered:t.found||q(o),decided:n.decided}),context:t.context||R({window:w,question:b,answered:t.found||q(o)}),world:n.world,research:!!n.research&&!n.world,answered:t.answered??(t.found||q(o)),answer:t.answer,parts:t.parts,facts:t.facts,plan:{steps:I},timing:{...t.timing,ms:d()-u},window:w};if(P.status==="waiting"){const{settings:s,can:i,...a}=n,r={...G,status:"waiting",ask:P.waiting[0]?.ask||null,checkpoint:{lane:k.id,route:a,outputs:P.checkpoint.outputs,waiting:P.waiting.map(f=>f.stepId)}};return l.runFinished({lane:k.id,status:"waiting"}),r}const H=t.answer&&(t.answer.final||x.write)?"answered":"prepared";return l.runFinished({lane:k.id,status:H,found:t.facts.filter(s=>s?.found).length,parts:t.parts.length}),{...G,status:H}}catch(p){const n=String(p?.message||p);return l.runError(n),N({status:"failed",error:n})}}function qe(e={},{answer:d=""}={}){if(e.answer?.final)return{text:e.answer.text,note:e.answer.note||""};const u=String(d||"");if(!u.trim())return{text:u,note:""};const o=Ae({answer:u,messages:e.messages||[],window:e.window??0});return{text:o?`${u}
3
3
 
4
- ${c}`:f,note:c}}export{_e as TURN_STAGES,ze as defineLane,Se as finishTurn,Ce as listLanes,Ae as routeByRule,Be as runTurnPipeline};
4
+ ${o}`:u,note:o}}export{Be as TURN_STAGES,Me as defineLane,qe as finishTurn,We as listLanes,Ee as routeByRule,Ge as runTurnPipeline};