@theihtisham/agent-shadow-brain 7.2.0 → 7.22.1

package/dist/context-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-cli.d.ts","sourceRoot":"","sources":["../src/context-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC9D"}
+{"version":3,"file":"context-cli.d.ts","sourceRoot":"","sources":["../src/context-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE9D"}

package/dist/context-cli.js

@@ -3,6 +3,13 @@ import * as path from 'node:path';
 import { getGlobalBrain, GlobalBrain } from './brain/global-brain.js';
 import { assembleContext } from './brain/context-assembly.js';
 import { FeatureSettingsStore, FEATURE_DEFINITIONS } from './brain/feature-settings.js';
+import { memoryAnnotationsFor } from './brain/memory-annotations.js';
+import { parseContextRequest } from './brain/context-request.js';
+import { inspectMemoryHealth } from './brain/memory-inspection.js';
+import { ProjectFeedbackStore } from './brain/project-feedback.js';
+import { resolveProjectStore } from './brain/project-memory.js';
+import { ProjectPolicyStore } from './brain/project-policy.js';
+import { enforceProjectContext } from './brain/project-policy-delivery.js';
 export function registerContextCommands(program) {
     program.command('context-pack').description('Build a bounded, explained project context pack without model calls')
         .argument('[query]', 'Current task or search terms', '')
@@ -11,22 +18,36 @@ export function registerContextCommands(program) {
         .option('--db <path>', 'Explicit memory-store path')
         .option('--settings <path>', 'Explicit feature-settings file')
         .option('--token-budget <number>', 'Approximate token budget, including the rendered context', '2000')
+        .option('--max-entries <number>', 'Maximum selected memories, 1 to 30')
         .option('--cross-project', 'Request broader context when the feature is enabled')
+        .option('--profile <name>', 'Retrieval profile: legacy or adaptive', 'legacy')
+        .option('--no-related', 'Disable recorded one-hop expansion in adaptive retrieval')
         .option('--json', 'Print entries, exclusions, reasons, and budget as JSON')
         .action(async (query, opts) => {
         const tokenBudget = Number(opts.tokenBudget);
         if (!Number.isSafeInteger(tokenBudget) || tokenBudget < 0 || tokenBudget > 12000)
             throw new TypeError('Token budget must be an integer from 0 to 12000.');
-        const settings = new FeatureSettingsStore({ filePath: opts.settings ?? (opts.db ? path.join(path.dirname(path.resolve(opts.db)), 'feature-settings.json') : undefined) });
+        const local = resolveProjectStore(opts.project, opts.db);
+        const request = parseContextRequest({ projectId: opts.projectId ?? local?.projectId ?? GlobalBrain.projectIdFor(path.resolve(opts.project)),
+            query, tokenBudget, maxEntries: opts.maxEntries === undefined ? undefined : Number(opts.maxEntries),
+            includeCrossProject: !!opts.crossProject, profile: opts.profile, expandRelated: opts.related });
+        if (local && (request.projectId !== local.projectId || request.includeCrossProject)) {
+            throw new TypeError('This memory store is pinned to its local project.');
+        }
+        const dbPath = local?.storagePath ?? (opts.db ? path.resolve(opts.db) : undefined);
+        const brain = getGlobalBrain(dbPath ? { dbPath } : undefined);
+        const settings = new FeatureSettingsStore({ filePath: opts.settings ?? local?.settingsPath ?? (dbPath ? path.join(path.dirname(dbPath), 'feature-settings.json') : undefined) });
         const features = settings.get().features;
-        const brain = getGlobalBrain(opts.db ? { dbPath: path.resolve(opts.db) } : undefined);
         try {
             if (features.contextAssembly)
-                await brain.init();
-            const pack = assembleContext(brain, {
-                projectId: opts.projectId ?? GlobalBrain.projectIdFor(path.resolve(opts.project)),
-                query, tokenBudget, includeCrossProject: !!opts.crossProject, features,
-            });
+                brain.refresh();
+            const options = {
+                ...request, features,
+                feedback: features.contextAssembly && local && request.profile === 'adaptive' ? new ProjectFeedbackStore(local.root, brain).get() : undefined,
+                annotations: features.contextAssembly ? memoryAnnotationsFor(brain).get() : undefined,
+            };
+            const pack = assembleContext(brain, local
+                ? enforceProjectContext(local.root, brain, new ProjectPolicyStore(local.root, local.projectId).get(), options) : options);
             if (opts.json)
                 console.log(JSON.stringify(pack, null, 2));
             else {
@@ -39,6 +60,27 @@ export function registerContextCommands(program) {
             await brain.shutdown();
         }
     });
+    program.command('memory-health').description('Inspect scoped source, review, duplication, age, and relationship attention hints without model calls')
+        .option('--project <directory>', 'Project directory', process.cwd())
+        .option('--project-id <id>', 'Use an existing memory project ID directly')
+        .option('--db <path>', 'Explicit memory-store path')
+        .option('--limit <number>', 'Maximum attention items, 1 to 100', '30')
+        .action(async (opts) => {
+        const local = resolveProjectStore(opts.project, opts.db);
+        if (local && opts.projectId && opts.projectId !== local.projectId)
+            throw new TypeError('This memory store is pinned to its local project.');
+        const dbPath = local?.storagePath ?? (opts.db ? path.resolve(opts.db) : undefined);
+        const brain = getGlobalBrain(dbPath ? { dbPath } : undefined);
+        try {
+            brain.refresh();
+            console.log(JSON.stringify(inspectMemoryHealth(brain, memoryAnnotationsFor(brain).get(), {
+                projectId: opts.projectId ?? local?.projectId ?? GlobalBrain.projectIdFor(path.resolve(opts.project)), limit: Number(opts.limit),
+            }), null, 2));
+        }
+        finally {
+            await brain.shutdown();
+        }
+    });
     const features = new Command('features').description('Inspect or change the dedicated runtime feature controls');
     features.command('list').option('--settings <path>', 'Explicit feature-settings file').action((opts) => {
         console.log(JSON.stringify({ ...new FeatureSettingsStore({ filePath: opts.settings }).get(), definitions: FEATURE_DEFINITIONS }, null, 2));

package/dist/context-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-cli.js","sourceRoot":"","sources":["../src/context-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-cli.js","sourceRoot":"","sources":["../src/context-cli.ts"],"names":[],"mappings":"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"}

package/dist/curation-cli.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+/** Register project-scoped curation commands without initializing local services. */
+export declare function registerCurationCommands(program: Command): void;
+//# sourceMappingURL=curation-cli.d.ts.map

package/dist/curation-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curation-cli.d.ts","sourceRoot":"","sources":["../src/curation-cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsE/D"}

package/dist/curation-cli.js

@@ -0,0 +1,118 @@
+import * as path from 'node:path';
+import { Command } from 'commander';
+import { getGlobalBrain } from './brain/global-brain.js';
+import { MemoryAnnotationsError, MemoryAnnotationsStore, memoryAnnotationsFor, memoryState, } from './brain/memory-annotations.js';
+import { normalizeMemorySources } from './brain/memory-sources.js';
+function scoped(command) {
+    return command
+        .requiredOption('--project-id <id>', 'Existing memory project ID')
+        .option('--db <path>', 'Explicit memory-store path')
+        .option('--annotations <path>', 'Explicit annotation-store path');
+}
+function change(command) {
+    return scoped(command).option('--revision <number>', 'Require this annotation revision before writing');
+}
+function expectedRevision(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value))) {
+        throw new TypeError('Annotation revision must be a nonnegative integer.');
+    }
+    return Number(value);
+}
+function requireScope(projectId) {
+    if (!projectId.trim() || projectId !== projectId.trim())
+        throw new TypeError('Provide a nonempty project ID.');
+}
+async function runCuration(opts, perform) {
+    requireScope(opts.projectId);
+    const brain = getGlobalBrain(opts.db ? { dbPath: path.resolve(opts.db) } : undefined);
+    try {
+        await brain.init();
+        const store = opts.annotations
+            ? new MemoryAnnotationsStore({ filePath: opts.annotations, resolveMemory: id => brain.getEntry(id) })
+            : memoryAnnotationsFor(brain);
+        console.log(JSON.stringify(await perform(brain, store), null, 2));
+    }
+    finally {
+        await brain.shutdown();
+    }
+}
+function isMemoryEvent(event, projectId, memoryId) {
+    if (event.projectId !== projectId)
+        return false;
+    return event.command.kind === 'review'
+        ? event.command.memoryId === memoryId
+        : event.relation?.fromId === memoryId || event.relation?.toId === memoryId;
+}
+/** Register project-scoped curation commands without initializing local services. */
+export function registerCurationCommands(program) {
+    const curate = new Command('curate').description('Review stored memories and record explicit project relations');
+    scoped(curate.command('show').description('Inspect one memory, its sources, and its review history'))
+        .argument('<memory-id>')
+        .action((id, opts) => runCuration(opts, (brain, store) => {
+        const memory = brain.getEntry(id);
+        if (!memory || memory.projectId !== opts.projectId) {
+            throw new MemoryAnnotationsError('ANNOTATIONS_NOT_FOUND', 'Memory was not found in the selected project.');
+        }
+        const { projectId, projectName, agentTool, category, content, createdAt, metadata } = memory;
+        const snapshot = store.get();
+        const review = snapshot.reviews[id];
+        const links = snapshot.links.filter(link => link.projectId === projectId && (link.fromId === id || link.toId === id))
+            .map(link => {
+            const otherId = link.fromId === id ? link.toId : link.fromId;
+            return { ...link, otherId, otherAvailable: brain.getEntry(otherId)?.projectId === projectId };
+        });
+        return {
+            id, projectId, projectName, agentTool, category, content, createdAt,
+            sources: normalizeMemorySources(metadata),
+            state: memoryState(snapshot, projectId, id),
+            review: review?.projectId === projectId ? review : null,
+            links,
+            history: snapshot.history.filter(event => isMemoryEvent(event, projectId, id)),
+            revision: snapshot.revision,
+        };
+    }));
+    change(curate.command('review').description('Set a manual review state for a memory'))
+        .argument('<memory-id>')
+        .argument('<state>', 'active, archived, or contested')
+        .option('--note <text>', 'Optional review note')
+        .action((memoryId, state, opts) => {
+        const revision = expectedRevision(opts.revision);
+        return runCuration(opts, async (_brain, store) => {
+            const snapshot = await store.update({ kind: 'review', projectId: opts.projectId, memoryId, state, note: opts.note }, revision);
+            return {
+                memoryId, projectId: opts.projectId, revision: snapshot.revision, updatedAt: snapshot.updatedAt,
+                state: memoryState(snapshot, opts.projectId, memoryId), review: snapshot.reviews[memoryId],
+            };
+        });
+    });
+    change(curate.command('link').description('Record a relation between memories in one project'))
+        .argument('<from-id>')
+        .argument('<to-id>')
+        .argument('<type>', 'related, supports, contradicts, or supersedes')
+        .option('--note <text>', 'Optional relation note')
+        .action((fromId, toId, type, opts) => {
+        const revision = expectedRevision(opts.revision);
+        return runCuration(opts, async (_brain, store) => {
+            const snapshot = await store.update({ kind: 'link', projectId: opts.projectId, fromId, toId, type, note: opts.note }, revision);
+            return { projectId: opts.projectId, revision: snapshot.revision, updatedAt: snapshot.updatedAt,
+                link: snapshot.history[snapshot.history.length - 1].relation };
+        });
+    });
+    change(curate.command('unlink').description('Remove an explicit relation and retain its audit event'))
+        .argument('<link-id>')
+        .action((linkId, opts) => {
+        const revision = expectedRevision(opts.revision);
+        return runCuration(opts, async (_brain, store) => {
+            const before = store.get();
+            const link = before.links.find(item => item.id === linkId && item.projectId === opts.projectId);
+            if (!link)
+                throw new MemoryAnnotationsError('ANNOTATIONS_NOT_FOUND', 'Memory relation was not found in the selected project.');
+            const snapshot = await store.update({ kind: 'unlink', linkId }, revision ?? before.revision);
+            return { projectId: opts.projectId, revision: snapshot.revision, updatedAt: snapshot.updatedAt, linkId };
+        });
+    });
+    program.addCommand(curate);
+}
+//# sourceMappingURL=curation-cli.js.map

package/dist/curation-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curation-cli.js","sourceRoot":"","sources":["../src/curation-cli.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/brain-hub-actions.d.ts

@@ -0,0 +1,2 @@
+export declare const BRAIN_HUB_ACTIONS: string;
+//# sourceMappingURL=brain-hub-actions.d.ts.map

package/dist/dashboard/brain-hub-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-hub-actions.d.ts","sourceRoot":"","sources":["../../src/dashboard/brain-hub-actions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAwO7B,CAAC"}

package/dist/dashboard/brain-hub-actions.js

@@ -0,0 +1,234 @@
+export const BRAIN_HUB_ACTIONS = String.raw `
+async function roomWrite(input){
+  if(!state.room)throw new Error('Select a room first.');
+  state.room=await hubWrite('hub/rooms/'+encodeURIComponent(state.room.room.id)+'/actions',input);
+}
+async function lessonWrite(id,input){
+  const {lesson}=await hubWrite('hub/lessons/'+encodeURIComponent(id)+'/actions',input);
+  if(lesson)state.hub={...state.hub,lessons:arr(state.hub?.lessons).map(item=>item.id===id?lesson:item)};
+  return afterSave(refreshHub,...(input.kind!=='evaluate'?[refreshGraph]:[]));
+}
+async function inspectApprovedMemory(id){
+  state.graph=await api('graph'+projectQuery({limit:graphMemoryLimit,memory:id}));
+  openView('overview');
+  await chooseMemory('memory:'+id);
+}
+function handleClick(event){
+  const button=event.target.closest('button');
+  if(!button||button.disabled)return;
+  const data=button.dataset;
+  if(handleAgentDock(button))return;
+  if(data.policyTool){void mutation(()=>saveProjectPolicy({kind:'set-tool-participation',tool:data.policyTool,enabled:data.enabled==='true'}),button,'Tool participation saved.');return;}
+  if(data.policyChat){void mutation(()=>saveProjectPolicy({kind:'set-chat-sharing',sessionId:data.policyChat,shareContext:data.enabled==='true'}),button,'Conversation sharing saved.');return;}
+  if(data.view){openView(data.view);return;}
+  if(data.project){
+    if(!state.pending&&data.project!==state.project){state.project=data.project;resetScope();render();void refresh(true);}
+    return;
+  }
+  if(data.node){void chooseMemory(data.node);return;}
+  if(data.graphMemory){void focusGraphMemory(data.graphMemory,data.graphProject);return;}
+  if(data.graphFilter){filterGraph(data.graphFilter);return;}
+  if(data.inspect){state.inspector=data.inspect;renderInspector();$('inspector').querySelector('[data-inspect="'+data.inspect+'"]')?.focus({preventScroll:true});return;}
+  if(data.event){
+    setReplay(state.events.findIndex(item=>item.id===data.event));
+    const replacement=[...(button.closest('#graph-exchanges')?$('graph-exchanges'):button.closest('#timeline')?$('timeline'):button.closest('#trace-list')?$('trace-list'):$('inspector'))?.querySelectorAll('[data-event]')??[]]
+      .find(item=>item.dataset.event===data.event);
+    (replacement??$('inspector')?.querySelector('[data-inspect=event]'))?.focus({preventScroll:true});
+    return;
+  }
+  if(data.nativeThread){void mutation(async()=>{invalidateNativeRequest();state.nativeThreadCursor=null;state.nativeThread=await api('sessions/codex/threads/'+encodeURIComponent(data.nativeThread),{timeoutMs:15000});nativeTimer=setTimeout(()=>void refreshNativeChats(),10000);},button,'Original history page opened.');return;}
+  if(data.session){void mutation(async()=>{state.sessionBefore=null;state.sessionCheckpoint=null;state.session=await api('sessions/'+data.session);},button,'Conversation opened.');return;}
+  if(data.source){void mutation(async()=>{state.source=(await api('sources/'+encodeURIComponent(data.source))).source;},button,'Source opened.');return;}
+  if(data.document){void mutation(()=>loadDocuments(data.document),button,'Document opened.');return;}
+  if(data.page){state.docPage=Number(data.page);render();return;}
+  if(data.room){void mutation(()=>loadRoom(data.room),button,'Room opened.');return;}
+  if(data.feature){
+    if(!state.features||featureLimit(data.feature))return;
+    const feature=data.feature;
+    void mutation(async()=>{
+      state.features=await api('features',json({patch:{[feature]:!state.features.features[feature]},expectedRevision:state.features.revision}));
+      if(feature==='liveActivity'||feature==='activityRecording'){
+        if(!state.features.features.liveActivity){state.live=false;state.events=[];state.replayId=null;state.replayExpired=false;state.cursor=undefined;state.journalId=undefined;}
+        else state.live=true;
+        void refresh();
+      }
+    },button,'Feature setting saved.');return;
+  }
+  if(data.roomAction){
+    const kind=data.roomAction;
+    const payload=kind==='ack-message'||kind==='ack-artifact'?{kind:'ack',targetType:kind.slice(4),targetId:data.id,...(data.sha256?{sha256:data.sha256}:{})}:
+      kind==='accept'?{kind,artifactId:data.id}:{kind,taskId:data.id,revision:Number(data.revision)};
+    void mutation(()=>roomWrite(payload),button);return;
+  }
+  if(data.lessonAction){void mutation(()=>lessonWrite(data.id,{kind:data.lessonAction}),button);return;}
+  if(data.lessonFrom){state.lessonFrom=data.lessonFrom;openView('learning');return;}
+  if(!data.action)return;
+  if(data.action.startsWith('copy-')){
+    if(data.action==='copy-pack'&&local){
+      const pack=state.context;
+      if(!pack?.markdown)return;
+      void api('project-policy').then(result=>{
+        installPolicy(result);
+        if(state.context!==pack){render(true);status('Project controls changed. Build a fresh context pack.',true);return;}
+        return clipboard(pack.markdown);
+      }).catch(failure=>status(failure.message,true));
+      return;
+    }
+    const host=arr(state.integrations?.agents).find(item=>item.id===data.host);
+    const current=displayEvent();
+    const checkpoint=arr(state.session?.checkpoints).find(item=>item.id===data.checkpoint);
+    const copies={
+      'copy-resume':checkpoint?JSON.stringify({tool:'session_resume',arguments:{sessionId:state.session.session.id,checkpointId:checkpoint.id,sha256:checkpoint.sha256,key:crypto.randomUUID()}},null,2):null,
+      'copy-host':host?.config?.content,'copy-command':host?.command,'copy-diagnostics':state.integrations?.diagnostics,
+      'copy-project-command':'shadow-brain project workspace .','copy-pack':state.context?.markdown,
+      'copy-memory':state.memory?.memory?.content??arr(state.graph?.nodes).find(node=>node.id===state.picked)?.snippet,
+      'copy-event':current?JSON.stringify(current,null,2):null,
+    };
+    void clipboard(copies[data.action]).catch(failure=>status(failure.message,true));return;
+  }
+  switch(data.action){
+    case 'managed-skill-preview':void mutation(async()=>{state.managedSkillPlan=await api('managed-skills/preview',json({id:data.id,action:data.kind}));},button,'Review the exact skill paths before applying.');break;
+    case 'managed-skill-cancel':state.managedSkillPlan=null;render(true);break;
+    case 'managed-skill-apply':void mutation(async()=>{const plan=state.managedSkillPlan;if(!plan||arr(plan.conflicts).length)return;
+      const result=await api('managed-skills/apply',json({id:plan.skill.id,action:plan.action,planHash:plan.planHash}));
+      state.managedSkillPlan=null;state.managedSkills=await api('managed-skills');delete state.errors.managedSkills;
+      return 'Managed skill '+result.finalState+'. '+result.hostRefreshNote;},button);break;
+    case 'download-example':{
+      const examples={
+        knowledge:{schemaVersion:1,kind:'knowledge',title:'Project notes',records:[{title:'Build command',content:'Run the build before release.',source:'README.md'}]},
+        transcript:{schemaVersion:1,kind:'transcript',title:'Review discussion',messages:[{role:'user',content:'Preserve Unicode.'},{role:'assistant',content:'The proposed constraint is to preserve Unicode.'}]},
+        simple:{messages:[{role:'user',content:'Preserve Unicode.'}]}
+      };
+      if(!Object.hasOwn(examples,data.example))break;
+      const url=URL.createObjectURL(new Blob([JSON.stringify(examples[data.example],null,2)+'\n'],{type:'application/json'}));
+      const link=document.createElement('a');link.href=url;link.download='shadow-brain-'+data.example+'-example.json';link.click();setTimeout(()=>URL.revokeObjectURL(url),1000);break;
+    }
+    case 'native-connect':void mutation(async()=>{invalidateNativeRequest();state.nativeConnection=await api('sessions/codex/connect',{...json({}),timeoutMs:30000});await refreshNativeChats(true);},button,'Read-only native connection opened.');break;
+    case 'native-disconnect':void mutation(async()=>{invalidateNativeRequest();nativeReload=false;state.nativeConnection=await api('sessions/codex/disconnect',json({}));state.nativeThreads=null;state.nativeThread=null;state.nativeListCursor=null;state.nativeThreadCursor=null;},button,'Native connection closed.');break;
+    case 'native-refresh':void refreshNativeChats(true);break;
+    case 'native-archive':invalidateNativeRequest();state.nativeArchived=!state.nativeArchived;state.nativeListCursor=null;state.nativeThreads=null;state.nativeThread=null;state.nativeThreadCursor=null;void refreshNativeChats(true);break;
+    case 'native-next':invalidateNativeRequest();state.nativeListCursor=data.cursor;state.nativeThread=null;state.nativeThreadCursor=null;void refreshNativeChats(true);break;
+    case 'native-first':invalidateNativeRequest();state.nativeListCursor=null;state.nativeThread=null;state.nativeThreadCursor=null;void refreshNativeChats(true);break;
+    case 'native-earlier':void mutation(async()=>{invalidateNativeRequest();state.nativeThreadCursor=data.cursor;state.nativeThread=await api('sessions/codex/threads/'+encodeURIComponent(state.nativeThread.thread.id)+'?cursor='+encodeURIComponent(data.cursor),{timeoutMs:15000});nativeTimer=setTimeout(()=>void refreshNativeChats(),10000);},button,'Earlier original history opened.');break;
+    case 'native-import':void mutation(async()=>{const result=await hubWrite('sessions/codex/threads/'+encodeURIComponent(state.nativeThread.thread.id)+'/import',{sha256:state.nativeThread.sha256,...(state.nativeThreadCursor?{cursor:state.nativeThreadCursor}:{})});state.session=result;state.sessionBefore=null;state.sessionCheckpoint=null;await refreshSessions();},button,'Original history page saved as a project snapshot.');break;
+    case 'session-checkpoint-open':void mutation(async()=>{state.sessionCheckpoint=(await api('sessions/'+state.session.session.id+'/checkpoints/'+data.checkpoint)).checkpoint;},button,'Checkpoint opened.');break;
+    case 'session-policy':state.policySelection=data.sessionPolicy;openView('setup');break;
+    case 'session-older':void mutation(async()=>{state.sessionBefore=data.before;await refreshSessions();},button,'Earlier messages loaded.');break;
+    case 'session-latest':void mutation(async()=>{state.sessionBefore=null;await refreshSessions();},button,'Latest messages loaded.');break;
+    case 'session-status':void mutation(async()=>{state.session=await hubWrite('sessions/'+state.session.session.id+'/actions',{kind:'status',status:data.status,expectedRevision:state.session.session.revision});await refreshSessions();},button,'Reported status saved.');break;
+    case 'session-resume':void mutation(async()=>{const cp=arr(state.session.checkpoints).find(item=>item.id===data.checkpoint);if(!cp)throw new Error('Choose a saved checkpoint.');state.sessionBefore=null;state.sessionCheckpoint=null;state.session=await hubWrite('sessions/'+state.session.session.id+'/resume',{checkpointId:cp.id,sha256:cp.sha256});await refreshSessions();},button,'New portal session created from this checkpoint.');break;
+    case 'import-session':void mutation(async()=>{if(!state.source)throw new Error('Choose a reviewed transcript.');state.session=await hubWrite('sessions/import',{sourceId:state.source.id});openView('sessions');await refreshSessions();},button,'Reviewed conversation snapshot opened.');break;
+    case 'source-evidence':void mutation(async()=>{state.evidence=await api('memory-evidence?'+new URLSearchParams({memoryId:data.memory}));if(state.view!=='knowledge')openView('knowledge');},button,'Source checked.');break;
+    case 'close-evidence':state.evidence=null;render(true);break;
+    case 'toggle-feedback':void mutation(async()=>{state.feedback=await api('project-feedback',json({kind:'toggle',enabled:!state.feedback.enabled,expectedRevision:state.feedback.revision}));},button,'Learning preference saved.');break;
+    case 'remove-feedback':void mutation(async()=>{state.feedback=await api('project-feedback',json({kind:'remove',id:data.feedback,expectedRevision:state.feedback.revision}));},button,'Feedback removed.');break;
+    case 'refresh':void refresh(true);break;
+    case 'refresh-room':void mutation(async()=>{await refreshHub();if(state.room)await loadRoom(state.room.room.id);},button,'Room refreshed.');break;
+    case 'graph':case 'trace':
+      state.graphMode=data.action;state.listing=false;state.pulseIds=[];render();$('main').querySelector('[data-action="'+data.action+'"]')?.focus();break;
+    case 'node-list':{
+      state.listing=!state.listing;button.setAttribute('aria-expanded',String(state.listing));
+      const target=$('node-list');target.hidden=!state.listing;syncGraphControls();drawGraph();if(state.listing)$('graph-search')?.focus();break;
+    }
+    case 'clear-graph-search':void findGraphMemories('');$('graph-search')?.focus();break;
+    case 'graph-zoom-in':if(button.getAttribute('aria-disabled')!=='true')zoomGraph(1);break;
+    case 'graph-zoom-out':if(button.getAttribute('aria-disabled')!=='true')zoomGraph(-1);break;
+    case 'graph-fit':zoomGraph('fit');break;
+    case 'clear-focus':state.focus=false;renderInspector();drawGraph();$('main').querySelector('[data-action=graph]')?.focus({preventScroll:true});break;
+    case 'pause':state.motionPaused=!state.motionPaused;state.pulseIds=[];updateOverviewLive();break;
+    case 'inspect-latest':state.inspector='event';renderInspector();break;
+    case 'live':state.replayId=null;state.replayExpired=false;renderChrome();updateOverviewLive();$('replay')?.focus({preventScroll:true});break;
+    case 'open-memory':void inspectApprovedMemory(data.memory).catch(failure=>status(failure.message,true));break;
+    case 'apply-skill':void mutation(async()=>{
+      if(!state.skill?.planHash||!state.skillInput)throw new Error('Preview a project skill before applying it.');
+      state.skill={...await api('project-skill-apply',json({...state.skillInput,expectedPlanHash:state.skill.planHash})),applied:true};
+    },button,'Reviewed project skill applied.');break;
+    case 'review-page':void mutation(async()=>{
+      const id=state.documents?.document?.id;
+      if(!id)throw new Error('Choose a document page first.');
+      state.documents=await hubWrite('hub/documents/'+encodeURIComponent(id)+'/review',{page:state.docPage,decision:data.decision});
+      return afterSave(refreshHub,refreshGraph);
+    },button,data.decision==='approve'?'Page approved and added to project memory.':'Page rejected.');break;
+  }
+}
+function handleSubmit(event){
+  const target=event.target;
+  if(target.id==='graph-find-form'){
+    event.preventDefault();
+    void findGraphMemories(field(new FormData(target),'query'));return;
+  }
+  const kind=target.dataset.form;
+  if(!kind)return;
+  event.preventDefault();
+  const form=new FormData(target,event.submitter),button=event.submitter;
+  const tasks={
+    'policy-context':()=>saveProjectPolicy({kind:'set-context-limits',context:{maxTokens:Number(form.get('maxTokens')),maxEntries:Number(form.get('maxEntries'))}}),
+    'policy-role':()=>saveProjectPolicy({kind:'set-session-role',sessionId:target.dataset.id,role:field(form,'role')||null}),
+    'native-export':async()=>{const file=form.get('export');if(!(file instanceof File)||!file.size)throw new Error('Choose a native export.');if(file.size>2*1024*1024)throw new Error('Choose an export smaller than 2 MiB.');const query=new URLSearchParams({tool:field(form,'tool'),name:file.name,key:crypto.randomUUID()});state.session=await api('sessions/native?'+query,{method:'POST',body:file,headers:{'Content-Type':file.name.endsWith('.zip')?'application/zip':'application/octet-stream'},timeoutMs:15000});state.sessionBefore=null;state.sessionCheckpoint=null;await refreshSessions();},
+    'session-open':async()=>{state.sessionBefore=null;state.sessionCheckpoint=null;state.session=await hubWrite('sessions',{title:field(form,'title'),goal:field(form,'goal')});await refreshSessions();},
+    'session-note':async()=>{state.session=await hubWrite('sessions/'+state.session.session.id+'/actions',{kind:'message',role:'note',text:field(form,'text'),expectedRevision:state.session.session.revision});await refreshSessions();},
+    'session-checkpoint':async()=>{const input={kind:'checkpoint',summary:field(form,'summary'),expectedRevision:state.session.session.revision};for(const name of ['decisions','completed','nextSteps','evidence'])input[name]=field(form,name).split(/\r?\n/).map(item=>item.trim()).filter(Boolean);state.session=await hubWrite('sessions/'+state.session.session.id+'/actions',input);await refreshSessions();},
+    teach:async()=>{
+      state.teachDraft=field(form,'text');
+      const save=form.get('mode')==='save';
+      state.source=(await api(save?'sources/remember':'sources?name=My-notes.txt',{method:'POST',body:state.teachDraft,headers:{'Content-Type':'text/plain'},timeoutMs:30000})).source;
+      await afterSave(async()=>{state.sources=await api('sources');},...(save?[refreshGraph]:[]));
+    },
+    'source-upload':async()=>{
+      const file=form.get('source');if(!(file instanceof File)||!file.size)throw new Error('Choose a text, Markdown or JSON file.');
+      if(file.size>1024*1024)throw new Error('Choose a file smaller than 1 MiB.');
+      state.source=(await api('sources?'+new URLSearchParams({name:file.name}),{method:'POST',body:file,headers:{'Content-Type':file.name.toLowerCase().endsWith('.json')?'application/json':'text/plain'}})).source;
+      state.sources=await api('sources');
+    },
+    'source-review':async()=>{
+      if(!state.source)throw new Error('Choose a source first.');
+      const decision=field(form,'decision');
+      const input={itemId:target.dataset.item,decision,...(decision==='approve'?{title:field(form,'title'),text:field(form,'text'),category:field(form,'category')}: {})};
+      state.source=(await hubWrite('sources/'+state.source.id+'/review',input)).source;
+      return afterSave(async()=>{state.sources=await api('sources');},refreshGraph);
+    },
+    feedback:async()=>{
+      state.feedback=await api('project-feedback',json({kind:'upsert',memoryId:field(form,'memoryId'),task:field(form,'task'),rating:field(form,'rating'),reason:field(form,'reason'),expectedRevision:state.feedback.revision}));
+    },
+    context:async()=>{
+      const input={projectId:state.project,query:field(form,'query'),tokenBudget:Number(form.get('tokenBudget')),profile:field(form,'profile'),expandRelated:form.has('expandRelated')};
+      state.contextInput=input;
+      if(form.get('compare')==='yes'){state.comparison=await api('context-compare',json(input));state.context=state.comparison[input.profile];}
+      else {state.context=await api('context',json(input));state.comparison=null;}
+    },
+    upload:async()=>{
+      const pdf=form.get('pdf');
+      if(!(pdf instanceof File)||!pdf.size)throw new Error('Choose a PDF to upload.');
+      if(state.hub?.limits?.pdfBytes&&pdf.size>state.hub.limits.pdfBytes)throw new Error('The PDF exceeds this workspace’s upload limit.');
+      state.documents=await api('hub/documents?'+new URLSearchParams({name:pdf.name}),{method:'POST',body:pdf,headers:{'Content-Type':'application/pdf'},timeoutMs:30000});
+      state.docPage=arr(state.documents.pages)[0]?.page??1;
+      return afterSave(refreshHub);
+    },
+    knowledge:async()=>{
+      const input={title:field(form,'title'),content:field(form,'content')};
+      const source=field(form,'source');if(source)input.source=source;
+      await api('project-knowledge',json(input));return afterSave(refreshGraph);
+    },
+    skill:async()=>{
+      const input={requirement:field(form,'requirement'),target:field(form,'target')};
+      const name=field(form,'name'),knowledge=field(form,'knowledge');
+      if(name)input.name=name;if(knowledge)input.knowledge=knowledge;
+      state.skill=await api('project-skill-preview',json(input));state.skillInput=input;
+    },
+    room:async()=>{state.room=await hubWrite('hub/rooms',{goal:field(form,'goal')});return afterSave(refreshHub);},
+    message:async()=>{const replyTo=field(form,'replyTo');await roomWrite({kind:'message',type:field(form,'type'),text:field(form,'text'),...(replyTo?{replyTo}:{})});},
+    task:()=>roomWrite({kind:'task',title:field(form,'title')}),
+    artifact:async()=>{
+      const taskId=field(form,'taskId'),task=arr(state.room?.tasks).find(item=>item.id===taskId);
+      if(!task)throw new Error('Choose a claimed task.');
+      await roomWrite({kind:'artifact',taskId,revision:task.revision,path:field(form,'path')});
+    },
+    outcome:()=>{const artifactId=field(form,'artifactId');return roomWrite({kind:'outcome',taskId:field(form,'taskId'),result:field(form,'result'),check:field(form,'check'),evidence:field(form,'evidence'),...(artifactId?{artifactId}:{})});},
+    lesson:async()=>{const {lesson}=await hubWrite('hub/lessons',{outcomeId:field(form,'outcomeId'),title:field(form,'title'),text:field(form,'text')});if(lesson)state.hub={...state.hub,lessons:[...arr(state.hub?.lessons),lesson]};state.lessonFrom=null;return afterSave(refreshHub);},
+    evaluate:()=>lessonWrite(target.dataset.id,{kind:'evaluate',baseline:form.has('baseline'),candidate:form.has('candidate'),control:form.has('control'),evidence:field(form,'evidence')}),
+  };
+  const operation=tasks[kind];
+  if(operation)void mutation(operation,button,kind==='teach'?(form.get('mode')==='save'?'Added to project memory. Try a related question in Context.':'Notes organized. Review each part before saving.'):kind==='source-upload'?'Source ready for review.':kind==='source-review'?'Review saved.':kind==='upload'?'PDF intake recorded.':kind==='context'?'Context pack assembled.':'Saved.');
+}
+`;
+//# sourceMappingURL=brain-hub-actions.js.map

package/dist/dashboard/brain-hub-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-hub-actions.js","sourceRoot":"","sources":["../../src/dashboard/brain-hub-actions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwO1C,CAAC"}

package/dist/dashboard/brain-hub-agent-dock.d.ts

@@ -0,0 +1,2 @@
+export declare const BRAIN_HUB_AGENT_DOCK: string;
+//# sourceMappingURL=brain-hub-agent-dock.d.ts.map

package/dist/dashboard/brain-hub-agent-dock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-hub-agent-dock.d.ts","sourceRoot":"","sources":["../../src/dashboard/brain-hub-agent-dock.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,QA4PhC,CAAC"}