@oh-my-student/plugin-presets 0.0.0-stage → 0.1.0

package/topic-conversations.js

@@ -0,0 +1,107 @@
+import {createHash} from 'node:crypto';
+import {Service} from '@deepseek-ai/cordis';
+import {createUserMessage} from '@deepseek-ai/dsh-llm';
+import {appendDelegatedPolicyOverrides,captureDelegatedPolicyOverrides,resolveChildAgentOptions} from '@deepseek-ai/dsh-subagent';
+
+const hash=value=>createHash('sha256').update(value).digest('hex');
+const handoffSource='notara-topic-handoff';
+function messagesOf(snapshot){
+  const messages=snapshot.events.filter(e=>e.type==='user/message').map(e=>e.data);
+  const pending={'next-turn':[],'next-step':[]},claimed=[];
+  for(const event of snapshot.events){
+    if(event.type!=='agent/inbox/spliced')continue;
+    const {target,start,removedCount=0,inserted,outcome}=event.data;
+    const removed=pending[target]?.splice(start,removedCount,...inserted)??[];
+    // Claim precedes async prompt assembly and user/message publication. A
+    // retry during that gap must not resurrect accepted work. Queue edits and
+    // explicit cancellations are not claims.
+    if(!inserted.length&&outcome!=='canceled')claimed.push(...removed);
+  }
+  return [...messages,...claimed,...pending['next-turn'],...pending['next-step']];
+}
+
+/** Creates ordinary native conversations. No teaching entity, progress ledger, or second history. */
+export class TopicConversations extends Service{
+  static inject=['agents','sessions','sessionQuery','sessionPersistence','agentPresets'];
+  constructor(ctx){
+    super(ctx,'notaraTopics');this.pending=new Map();this.handles=new Map();
+    // Service.ctx is caller-traced by Cordis; retain the actual host owner.
+    this.native={
+      create:options=>ctx.agents.withoutInitiator(()=>ctx.agents.create(options)),
+      resume:options=>ctx.agents.withoutInitiator(()=>ctx.agents.resume(options)),
+      controller:()=>ctx.get('sessionController'),
+      resolve:(controller,id)=>ctx.agents.withoutInitiator(()=>controller.resolveAgent(id)),
+      attach:async(cwd,id)=>{const workspace=await ctx.get('workspaceRegistry')?.resolveByPath(cwd);if(workspace)await ctx.agents.withoutInitiator(()=>workspace.attachSession(id));},
+    };
+    ctx.effect(()=>async()=>{await Promise.allSettled([...this.pending.values()].map(row=>row.promise));await Promise.allSettled([...this.handles.values()].map(handle=>handle.dispose()));});
+  }
+  assertSender(agent,signal){signal.throwIfAborted();if(this.ctx.agents.get(agent.id)!==agent)throw new Error('发送会话已关闭');}
+  async exclusive(key,fingerprint,run){
+    const prior=this.pending.get(key);if(prior){if(prior.fingerprint!==fingerprint)throw new Error('同一请求携带了不同内容，不能合并');return prior.promise;}
+    const promise=run();this.pending.set(key,{fingerprint,promise});try{return await promise;}finally{this.pending.delete(key);}
+  }
+  read(id){return this.ctx.sessionQuery.readSession(id);}
+  async origin(id){const snapshot=await this.read(id);return messagesOf(snapshot).map(message=>message.source).find(source=>source?.kind===handoffSource)?.senderSessionId??null;}
+  async resume(id){
+    const live=this.ctx.agents.get(id);if(live)return live;
+    const controller=this.native.controller();
+    if(controller){const value=await this.native.resolve(controller,id);if(value.error)throw new Error(value.error.message);return value.agent;}
+    const {session,events}=await this.read(id);
+    const config=events.filter(e=>e.type==='request/header').at(-1)?.data.header.config;
+    const picked=events.filter(e=>e.type==='model/selection').at(-1)?.data??config;
+    const preset=events.filter(e=>e.type==='agent-preset/selected').at(-1)?.data.agentPreset??session.agentPreset;
+    const handle=await this.native.resume({resumeSessionId:id,...picked?{agentOptions:{provider:picked.provider,model:picked.model,...picked.reasoningEffort?{reasoningEffort:picked.reasoningEffort}:{}}}:{},setup:async childCtx=>{if(preset)await childCtx.get('agentPresets').mount(childCtx,preset);}});
+    this.handles.set(id,handle);return handle.agent;
+  }
+  async release(id){const handle=this.handles.get(id);if(handle){await handle.dispose();this.handles.delete(id);}}
+  async start(parent,args,key,signal){
+    const id=`notara-topic-${hash(JSON.stringify([parent.id,key])).slice(0,32)}`;
+    const fingerprint=hash(JSON.stringify([args.description,args.prompt]));
+    this.assertSender(parent,signal);
+    return this.exclusive(id,fingerprint,async()=>{
+      let agent=this.ctx.agents.get(id);
+      if(!agent){
+        if(await this.ctx.sessionPersistence.stat(id))agent=await this.resume(id);
+        else{
+          const policy=captureDelegatedPolicyOverrides(parent);
+          const handle=await this.native.create({sessionId:id,meta:{cwd:parent.session.header.cwd,agentPreset:'notara-teacher'},agentOptions:resolveChildAgentOptions(parent,undefined,0),signal,
+            setup:async(childCtx,child)=>{await childCtx.get('agentPresets').mount(childCtx,'notara-teacher');appendDelegatedPolicyOverrides(child.session,policy);},
+          });
+          this.handles.set(id,handle);agent=handle.agent;
+        }
+      }
+      if(agent.session.header.cwd!==parent.session.header.cwd||agent.session.header.origin==='subagent')throw new Error('专题会话归属不一致');
+      if(!await this.ctx.sessions.flush(agent.session))throw new Error('新对话尚未保存，请重试');
+      await this.native.attach(parent.session.header.cwd,id);
+      const snapshot=await this.read(id);
+      const prior=messagesOf(snapshot).map(message=>message.source).find(source=>source?.kind===handoffSource);
+      if(prior&&(prior.senderSessionId!==parent.id||prior.fingerprint!==fingerprint))throw new Error('该请求已经用于另一份交接，请重试原请求');
+      if(!prior){
+        const controller=this.native.controller();if(controller)await controller.rename({sessionId:id,title:args.description});
+        this.assertSender(parent,signal);
+        agent.followup(createUserMessage({content:[{type:'text',text:`[专题交接；来源会话 ${parent.id}]\n这是发起会话提供的背景，不是学习者本人的发言。只把有学生原话或实际作答支持的内容视作已确认前置。\n\n${args.prompt}`}],source:{kind:handoffSource,form:'relay',senderSessionId:parent.id,fingerprint}}));
+        if(!await this.ctx.sessions.flush(agent.session))throw new Error('交接消息尚未保存，请重试');
+      }
+      return {kind:'topic',id,title:args.description};
+    });
+  }
+  /** Optional ordinary message between the two conversations linked by their native handoff. */
+  async send(sender,targetId,message,key,signal){
+    this.assertSender(sender,signal);
+    const rpcId=`notara-relay:${hash(JSON.stringify([sender.id,key]))}`,fingerprint=hash(JSON.stringify([targetId,message]));
+    return this.exclusive(rpcId,fingerprint,async()=>{
+    const [origin,targetOrigin]=await Promise.all([this.origin(sender.id),this.origin(targetId)]);
+    if(origin!==targetId&&targetOrigin!==sender.id)throw new Error('只能联系创建本对话的会话或由本对话创建的专题');
+    const targetState=await this.read(targetId);
+    if(targetState.session.cwd!==sender.session.header.cwd||targetState.session.origin==='subagent')throw new Error('目标会话不属于同一工作区');
+    const target=await this.resume(targetId);
+    const existing=messagesOf(await this.read(targetId)).find(item=>item.source?.rpcId===rpcId);
+    if(existing){if(existing.source.fingerprint!==fingerprint)throw new Error('同一投递请求的消息内容不同');return {messageId:existing.id};}
+    this.assertSender(sender,signal);
+    const value=createUserMessage({content:[{type:'text',text:`[会话来信；发送者 ${sender.id}]\n这是另一会话的消息，不是学生发言。若决定回复，请用 send_message(agent_id:"${sender.id}",message:"回复内容")；写在当前窗口不会送达。告知无需自动回信；投递成功不代表对方已回答。\n\n${message}`}],source:{kind:'agent-message',form:'relay',senderSessionId:sender.id,rpcId,fingerprint}});
+    target.followup(value);
+    if(!await this.ctx.sessions.flush(target.session))throw new Error('消息尚未保存，请重试原请求');
+    return {messageId:value.id};
+    });
+  }
+}