openvisio-agent 0.25.2 → 0.25.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.25.3] — 2026-09-21
+
+- Normalize structured and compact Markdown MCP list results through one provider-neutral discovery path, so every runtime can resolve projects, agents, boards, tasks, task types, and channels from the same saved setup.
+- Recognize backend-generated dedicated channel names that append the agent identifier suffix, allowing first-connection introductions and fresh threads to reach the correct agent channel.
+
 ## [0.25.2] — 2026-09-21
 
 - Load each provider's available models in Agent Studio, apply the selected model exactly to new ACP sessions, and show the model the running watcher actually uses.

package/README.md

@@ -79,7 +79,7 @@ The integration follows Mastra's [semantic memory](https://mastra.ai/docs/memory
 
 Model selections are stable. Exact IDs (including reasoning effort) are preserved. An unsuffixed ACP model may resolve once to the same model with `medium` effort; the watcher saves that exact selection. Unavailable selections produce an explicit error rather than switching generations or families. Claude versioned IDs are preserved, with automatic family fallbacks disabled. Codex uses the configured chat model for replies.
 
-Backend/BYO watchers reconcile immediately whenever the process starts or the WebSocket connects. A direct MCP session discovers and caches the backend's actual `tools/list` response, then uses available tools such as `list_agents`, `list_projects`, `list_tasks`, `list_task_types`, and `list_activity` to recover assigned tasks and recent mention activity missed while offline. Optional actions such as ticket comments are used only when advertised; their absence cannot strand a completed ticket in a retry loop. The same zero-model check runs every five minutes as a safety net; a model starts only when pending work exists.
+Backend/BYO watchers reconcile immediately whenever the process starts or the WebSocket connects. A direct MCP session discovers and caches the backend's actual `tools/list` response, then uses available tools such as `list_agents`, `list_projects`, `list_tasks`, `list_task_types`, and `list_activity` to recover assigned tasks and recent mention activity missed while offline. Team discovery is shared by every runtime provider: structured MCP results and compact Markdown list envelopes are normalized once before the watcher resolves its project, identity, boards, tickets, or dedicated channel. Adding another model provider therefore reuses the same saved team connection and setup path instead of adding provider-specific project discovery. Optional actions such as ticket comments are used only when advertised; their absence cannot strand a completed ticket in a retry loop. The same zero-model check runs every 30 seconds as a safety net; a model starts only when pending work exists.
 
 The backend MCP may be stateful or stateless. A successful initialize response without `Mcp-Session-Id` is accepted as stateless, so OpenCode agents do not stop with “MCP initialize returned no session id.” Each OpenCode lane keeps its MCP identity in a private per-agent config directory while the repository is supplied separately with `--dir`; stale workspace configuration therefore cannot swap one agent's credentials for another's. The generated remote configuration sends the agent headers directly, disables OAuth probing, and backend cycles never request relay-only inbox calls or MCP resource-discovery tools in place of team actions.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openvisio-agent",
-  "version": "0.25.2",
+  "version": "0.25.3",
   "description": "Connect Claude Code, Codex, or OpenCode to an OpenVisio team \u2014 MCP tools + optional autonomy \u2014 in one command.",
   "type": "module",
   "bin": {

package/src/channel-routing.mjs

@@ -22,9 +22,10 @@ export function dedicatedChannel(channels, { id, identifier, aliases = [], chann
     return identifier && ownerIdentifier(channel) === identifier
   })
   if (owned.length) return owned.length === 1 ? owned[0] : null
+  const identifierSuffix = String(identifier || '').split('-').at(-1)?.toLowerCase() || ''
   const names = new Set([identifier, ...aliases].filter(Boolean).flatMap((alias) => {
     const name = normalize(alias)
-    return [name, `agent-${name}`, `${name}-agent`]
+    return [name, `agent-${name}`, `${name}-agent`, ...(identifierSuffix ? [`${name}-${identifierSuffix}`] : [])]
   }).filter((name) => !['general', 'team', 'project', 'dev', 'development'].includes(name)))
   // Explicit ownership always outranks a similar name. A recycled agent name
   // must never route a new thread into somebody else's dedicated channel.

package/src/team-data.mjs

@@ -0,0 +1,41 @@
+const COLLECTIONS = {
+  list_agents: ['agents', 'name'],
+  list_boards: ['boards', 'name'],
+  list_channels: ['channels', 'name'],
+  list_projects: ['projects', 'name'],
+  list_tasks: ['tasks', 'title'],
+  list_task_types: ['types', 'name'],
+}
+
+function markdownRows(markdown, labelKey) {
+  if (typeof markdown !== 'string') return []
+  const rows = []
+  for (const line of markdown.split(/\r?\n/)) {
+    const match = /^\s*-\s+`(#?\d+)`(?:\s+(.+?))?\s*$/.exec(line)
+    if (!match) continue
+    const id = Number(match[1].replace(/^#/, ''))
+    if (!Number.isSafeInteger(id) || id <= 0) continue
+    rows.push({ id, [labelKey]: String(match[2] || '').trim() })
+  }
+  return rows
+}
+
+function normalizeCollection(data, toolName) {
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return data
+  const collection = COLLECTIONS[toolName]
+  if (!collection) return data
+  const [key, labelKey] = collection
+  if (Array.isArray(data[key])) return data
+  const rows = markdownRows(data.markdown, labelKey)
+  return { ...data, [key]: rows }
+}
+
+// Team tools may return either structured arrays or a compact JSON envelope
+// containing Markdown rows. Normalize that transport difference here so every
+// runtime provider uses the same watcher discovery path.
+export function toolData(result, toolName = '') {
+  const text = result?.content?.find?.((item) => item?.type === 'text')?.text
+  if (typeof text !== 'string') return normalizeCollection(result?.structuredContent ?? result ?? {}, toolName)
+  try { return normalizeCollection(JSON.parse(text), toolName) }
+  catch { return normalizeCollection(result?.structuredContent ?? { text }, toolName) }
+}

package/src/watch.mjs

@@ -36,6 +36,7 @@ import { claudeFallbackModels, resolveClaudeModel } from './model-selection.mjs'
 import { createAgentJournal } from './agent-journal.mjs'
 import { readModelSettings } from './model-settings.mjs'
 import { startStudioInBackground } from './studio-cli.mjs'
+import { toolData } from './team-data.mjs'
 
 function runtimeJournal(options, supplied) {
   let journal
@@ -900,7 +901,11 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
   // MCP server returns list_agents as human-readable markdown without identifiers.
   const selfAliases = new Set([slug, name, identifier].map((value) => String(value || '').trim().toLowerCase()).filter(Boolean))
   const rememberSelfAgent = (self) => {
-    if (!self || typeof self !== 'object' || String(self.identifier || self.slug || '') !== identifier) return
+    if (!self || typeof self !== 'object') return
+    const declaredIdentifier = String(self.identifier || self.slug || '')
+    const matchesIdentifier = declaredIdentifier === identifier
+    const matchesSavedName = !declaredIdentifier && String(name || '').trim() && String(self.name || '').trim().toLowerCase() === String(name).trim().toLowerCase()
+    if (!matchesIdentifier && !matchesSavedName) return
     if (validBackendId(self.id)) selfAgentId = Number(self.id)
     for (const alias of [self.name, self.identifier, self.slug]) if (alias) selfAliases.add(String(alias).toLowerCase())
     identityContext = agentProfileContext(self, identifier)
@@ -933,8 +938,11 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
   const ensureSelfAgent = async () => {
     if (selfAgentId != null) return
     if (!selfRead && Date.now() < selfReadAfter) return
-    if (!selfRead) selfRead = callMcpTool('list_agents').then(toolData).then((data) => {
-      const self = (Array.isArray(data.agents) ? data.agents : []).find((row) => String(row?.identifier || row?.slug || '') === identifier)
+    if (!selfRead) selfRead = callMcpTool('list_agents').then((result) => toolData(result, 'list_agents')).then((data) => {
+      const agents = Array.isArray(data.agents) ? data.agents : []
+      const identified = agents.find((row) => String(row?.identifier || row?.slug || '') === identifier)
+      const named = agents.filter((row) => !row?.identifier && !row?.slug && String(row?.name || '').trim().toLowerCase() === String(name || '').trim().toLowerCase())
+      const self = identified || (named.length === 1 ? named[0] : null)
       rememberSelfAgent(self)
     }).catch((error) => {
       log('Agent profile unavailable; continuing with task ownership and configured aliases: ' + (error?.message || error))
@@ -989,13 +997,7 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
     }
   }
   if (mcpUrl) void discoverMcpTools().catch(() => {})
-  const toolData = (result) => {
-    const text = result?.content?.find?.((c) => c?.type === 'text')?.text
-    if (typeof text !== 'string') return result?.structuredContent ?? result ?? {}
-    try { return JSON.parse(text) } catch { return { text } }
-  }
-
-  const taskTypeSets = createTaskTypeLookup({ load: (projectId) => loadProjectTaskTypes({ projectId, listTools: () => mcpClient.listTools(), callTool: (name, args) => callMcpTool(name, args).then(toolData) }) })
+  const taskTypeSets = createTaskTypeLookup({ load: (projectId) => loadProjectTaskTypes({ projectId, listTools: () => mcpClient.listTools(), callTool: (name, args) => callMcpTool(name, args).then((result) => toolData(result, name)) }) })
 
   const callMcpReadWithRetry = async (name, args = {}) => {
     try { return await callMcpTool(name, args) }
@@ -1006,21 +1008,21 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
   }
 
   const loadPendingTickets = async () => {
-    const projectsData = toolData(await callMcpReadWithRetry('list_projects'))
+    const projectsData = toolData(await callMcpReadWithRetry('list_projects'), 'list_projects')
     const projects = Array.isArray(projectsData.projects) ? projectsData.projects : []
     const groups = await mapConcurrent(projects.filter((project) => project?.id != null), 3, async (project) => {
       const [tasksResult, typesResult] = await Promise.all([
         callMcpReadWithRetry('list_tasks', { project_id: project.id }),
         taskTypeSets(project.id),
       ])
-      const tasksData = toolData(tasksResult)
+      const tasksData = toolData(tasksResult, 'list_tasks')
       const { done: doneIds, review: reviewIds } = typesResult
       const tasks = await mapConcurrent(Array.isArray(tasksData.tasks) ? tasksData.tasks : [], 3, async (task) => {
         await resolveTaskOwner(task)
         if (ticketDisplaySlug(task) || task?.id == null || !taskBelongsToAgent(task, { id: selfAgentId, identifier })) return task
         // Some list responses omit the board slug. Resolve details by the real
         // database identity; never interpret the number in OPEN-105 as an id.
-        const data = toolData(await callMcpReadWithRetry('get_ticket', { project_id: project.id, ticket_id: task.id }))
+        const data = toolData(await callMcpReadWithRetry('get_ticket', { project_id: project.id, ticket_id: task.id }), 'get_ticket')
         const detail = data.ticket ?? data.task ?? data
         if (String(detail.id) !== String(task.id) || (detail.project_id != null && String(detail.project_id) !== String(project.id))) throw new Error('Ticket detail identity did not match its assignment.')
         return detail
@@ -1238,7 +1240,7 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
     dedicatedChannelRead = (async () => {
       try {
         await ensureSelfAgent()
-        const data = toolData(await callMcpTool('list_channels'))
+        const data = toolData(await callMcpTool('list_channels'), 'list_channels')
         const channels = data.channels ?? data.data?.channels ?? data.data ?? data.items ?? []
         const channel = dedicatedChannel(Array.isArray(channels) ? channels : [], { id: selfAgentId, identifier, aliases: [...selfAliases], channelId: readConfig(slug)?.dedicatedChannelId })
         const channelId = channel ? Number(channel.id) : null
@@ -1254,7 +1256,7 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
   }
 
   const announceIntroduction = async () => {
-    const projectsData = toolData(await callMcpTool('list_projects'))
+    const projectsData = toolData(await callMcpTool('list_projects'), 'list_projects')
     const projects = Array.isArray(projectsData.projects) ? projectsData.projects : []
     const project = projects.find((item) => Number.isFinite(Number(item.id)))
     if (!project) { log('no project available for first-connection introduction'); return false }
@@ -1423,7 +1425,7 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
     if (!mcpUrl || backlogProbeBusy) return
     backlogProbeBusy = true
     try {
-      const projectsData = toolData(await callMcpTool('list_projects'))
+      const projectsData = toolData(await callMcpTool('list_projects'), 'list_projects')
       const projects = Array.isArray(projectsData.projects) ? projectsData.projects : []
       const mentionActivity = []
       let activityReplayTouched = false
@@ -1431,7 +1433,7 @@ export function createBackendWatcher({ backend, wsUrl, apiKey, identifier, slug,
         try {
           const assigned = []
           const [tasksData, typesData] = await Promise.all([
-            callMcpTool('list_tasks', { project_id: project.id }).then(toolData),
+            callMcpTool('list_tasks', { project_id: project.id }).then((result) => toolData(result, 'list_tasks')),
             taskTypeSets(project.id),
           ])
           const { done: doneIds, review: reviewIds } = typesData