@eclipse-docks/extension-ai-system 0.7.140 → 0.7.141

package/README.md

@@ -0,0 +1,72 @@
+# `@eclipse-docks/extension-ai-system`
+
+Cognitive chat runtime for Eclipse Docks: sessions, model routing, tool broker with approval modes, and a UI-agnostic event bus. Consumers use `@eclipse-docks/extension-ai-system/api`.
+
+## Status
+
+The **harness** (prompt → specialist loop → tools → approvals → streaming UI) is the working product path.
+
+Composer supports **attachments** (paperclip / drag-drop, up to 8). Payloads (text or image data URLs) are stored on the **session**, not inlined into chat history. The user turn only publishes a lightweight reference; the model calls `attachment_list` / `attachment_read` when it needs contents (images are presented for vision only on read). This keeps baseline token use low.
+
+Supported: text files (≤~100k chars stored) and visual media (jpeg/png/gif/webp/svg/ico/bmp/avif/tiff, ≤4MB). SVG keeps source text for `attachment_read` plus a preview data URL. Audio/video rejected.
+
+**ICOM Core** (`runtime/core`) and **ACT-R memory** (`runtime/memory` + session buffers) are wired into each turn but do not yet drive model policy, tool policy, or prompt content in a meaningful way. Treat them as scaffolding until the todos below land.
+
+See also `docs/internal/icom-agentic-runtime.md` for the layer map.
+
+## Finalize implementation
+
+### ICOM Core — make motivation real
+
+- [ ] Feed intent / dominant need / valence into the specialist system prompt (not only `goal ≈ user text`)
+- [ ] Let needs/valence influence routing (e.g. `safety` → prefer ask / lower-risk tools; `clarity` → explore/plan)
+- [ ] Update need urgency from turn outcomes (tool failure, user correction, success) via `bumpNeed`
+- [ ] Surface `TOPIC.coreTick` in the UI (optional debug panel: conscious valence, need, intent)
+- [ ] Decide whether subconscious state affects anything beyond blending, or drop it until needed
+
+### ACT-R memory — close the loop
+
+- [ ] Inject top retrieved chunks into the LLM context (system or dedicated message), not only the `retrieval` buffer for `coreTick`
+- [ ] Call `decay()` on a schedule (per turn or idle) so activation ranking matters over time
+- [ ] Use `imaginal` / `motor` buffers or remove them from `BufferMap` until there is a real producer/consumer
+- [ ] Persist utility-relevant episodic structure (what worked) and retrieve by task similarity, not only keyword overlap
+- [ ] Pin / forget UX for workspace-scoped chunks (or API for extensions)
+
+### Specialist roles & Plan/Build
+
+- [ ] Role picker in `docks-cognitive-view` (`plan` / `explore` / `build` / `general`)
+- [ ] Default role from ICOM intent / need instead of hard-coded `build`
+- [ ] Explicit Plan → approve → Build handoff (checkpoint + user gate), not only read-only tool filters
+- [ ] Compact / title / summary specialists invoked automatically with economy models
+
+### Tool broker & approvals
+
+- [ ] Persist allow/deny rules and approval mode across reloads
+- [ ] Cache risk classifications per tool (or signature) to avoid a classify call every batch in `auto_safe`
+- [ ] Show why a tool was classified critical in the approval UI
+- [ ] Align WebMCP / other `cmd_*` callers with first-class command tool names
+
+### Model router & transport
+
+- [ ] Persist router utility scores with cognitive state
+- [ ] Move tool + reasoning to Responses API (or equivalent) so `reasoning_effort` and tools can coexist
+- [ ] Re-enable effort levels when tools are required, once transport allows
+- [ ] Expose manual effort override consistently with Models.dev capabilities
+
+### Sessions, context & compaction
+
+- [x] Inject `compactionSummary` into provider messages; LLM summarize on compact (extractive fallback)
+- [ ] Auto-compact threshold tunable in settings; compact summary should include ACT-R goal/retrieval highlights
+- [ ] Keep context-usage estimate in sync with what is actually sent to the provider (retrieved chunks, enhancers)
+- [ ] Checkpoint restore should rehydrate Core state, not only session buffers/history
+
+### Consumer API & docs
+
+- [ ] Document `./api` surface (runtime, `TOPIC`, enhancers, external providers, settings helpers)
+- [ ] Fix stale references (`cmd_*` tool prefix, command ids) in internal docs
+- [ ] e2e coverage for approval modes, external provider registration, and prompt enhancers
+
+### Cleanup
+
+- [ ] Remove or quarantine any leftover pre-cognitive modules if still present in the tree
+- [ ] Trim public exports to the stable façade; keep Core/memory internals package-private unless consumers need them

package/dist/api.d.ts

@@ -1,8 +1,2 @@
-export * from './core';
-export { aiService } from './service/ai-service';
-export type { AIService } from './service/ai-service';
-export * from './providers';
-export * from './tools';
-export { AgentRegistry, PromptBuilder, MessageProcessorService, } from './agents';
-export * from './workflows';
+export { cognitiveRuntime, CognitiveRuntime, TOPIC, AI_VIEW_NAME, AI_SETTINGS_KEY, AI_SETTINGS_EDITOR_ID, OPEN_AI_SETTINGS_COMMAND, defaultProvidersSettings, fetchOpenAICompatibleModels, listConfiguredModelIds, loadModelsCatalog, parseModelIds, OpenAICompatibleProvider, type ChatMessage, type MessagePart, type PromptAttachment, type SessionAttachment, type CognitiveSession, type Checkpoint, type ModelPolicy, type EffortLevel, type OptimizeFor, type SpecialistRole, type PermissionAction, type ToolApprovalMode, type EmotionalState, type ProviderConfig, type ProvidersSettings, type RemoteModelInfo, type ModelProvider, type StreamParams, type StreamChunk, type ProviderChatMessage, type SystemPromptEnhancer, } from './runtime';
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,OAAO,EACH,aAAa,EACb,aAAa,EACb,uBAAuB,GAC1B,MAAM,UAAU,CAAC;AAClB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC"}

package/dist/api.js

@@ -1,2 +1,2 @@
-import { A as CID_AGENTS, B as TOPIC_AICONFIG_CHANGED, C as BaseProvider, D as SSEParser, E as OllamaParser, F as MAX_RECENT_TOOL_CALLS, H as TOPIC_AI_STREAM_COMPLETE, I as MAX_TOOL_ITERATIONS, L as TOPIC_AGENT_WORKFLOW_COMPLETE, M as CID_PROMPT_ENHANCERS, N as DEFAULT_AGENT_ROLE, O as StreamParser, P as KEY_AI_CONFIG, R as TOPIC_AGENT_WORKFLOW_ERROR, S as OpenAIProvider, T as streamToText, U as TOPIC_AI_STREAM_ERROR, V as TOPIC_AI_STREAM_CHUNK, W as TOPIC_AI_STREAM_STARTED, _ as MessageProcessorService, a as WorkflowEngine, b as ProviderFactory, c as PipelineWorkflowStrategy, d as BaseSequentialWorkflow, f as ParallelWorkflowStrategy, g as ToolCallAccumulator, h as sanitizeFunctionName, i as TokenEstimator, j as CID_CHAT_PROVIDERS, k as AI_CONFIG_TEMPLATE, l as ConditionalWorkflowStrategy, m as ToolExecutor, o as ReviewWorkflowStrategy, p as ToolRegistry, s as OrchestratedWorkflowStrategy, t as aiService, u as SequentialWorkflowStrategy, v as PromptBuilder, w as extractBaseUrl, x as OllamaProvider, y as AgentRegistry, z as TOPIC_AGENT_WORKFLOW_STARTED } from "./ai-service-Cmafte5S.js";
-export { AI_CONFIG_TEMPLATE, AgentRegistry, BaseProvider, BaseSequentialWorkflow, CID_AGENTS, CID_CHAT_PROVIDERS, CID_PROMPT_ENHANCERS, ConditionalWorkflowStrategy, DEFAULT_AGENT_ROLE, KEY_AI_CONFIG, MAX_RECENT_TOOL_CALLS, MAX_TOOL_ITERATIONS, MessageProcessorService, OllamaParser, OllamaProvider, OpenAIProvider, OrchestratedWorkflowStrategy, ParallelWorkflowStrategy, PipelineWorkflowStrategy, PromptBuilder, ProviderFactory, ReviewWorkflowStrategy, SSEParser, SequentialWorkflowStrategy, StreamParser, TOPIC_AGENT_WORKFLOW_COMPLETE, TOPIC_AGENT_WORKFLOW_ERROR, TOPIC_AGENT_WORKFLOW_STARTED, TOPIC_AICONFIG_CHANGED, TOPIC_AI_STREAM_CHUNK, TOPIC_AI_STREAM_COMPLETE, TOPIC_AI_STREAM_ERROR, TOPIC_AI_STREAM_STARTED, TokenEstimator, ToolCallAccumulator, ToolExecutor, ToolRegistry, WorkflowEngine, aiService, extractBaseUrl, sanitizeFunctionName, streamToText };
+import { _ as AI_SETTINGS_KEY, b as TOPIC, d as defaultProvidersSettings, f as listConfiguredModelIds, g as AI_SETTINGS_EDITOR_ID, h as loadModelsCatalog, l as OpenAICompatibleProvider, n as cognitiveRuntime, p as parseModelIds, t as CognitiveRuntime, u as fetchOpenAICompatibleModels, v as AI_VIEW_NAME, y as OPEN_AI_SETTINGS_COMMAND } from "./runtime-DfNGzEjU.js";
+export { AI_SETTINGS_EDITOR_ID, AI_SETTINGS_KEY, AI_VIEW_NAME, CognitiveRuntime, OPEN_AI_SETTINGS_COMMAND, OpenAICompatibleProvider, TOPIC, cognitiveRuntime, defaultProvidersSettings, fetchOpenAICompatibleModels, listConfiguredModelIds, loadModelsCatalog, parseModelIds };