Skip to content

Navigation ​

Move the user to another part of Omniscio: one of their sessions, or a conversation with a teammate.

Availability: Webview only (Omniscio.navigation). There is no ctx.navigation. Required Permission: navigation

Permissions ​

navigation is a standard permission. Omniscio shows it to the user as "Navigation: Navigate Omniscio to your sessions, projects, and views".

json
{
  "permissions": ["navigation"]
}

Rate limited

Calls are limited per plugin to 10 in 5 seconds, so a runaway loop cannot keep taking the user's focus. Call these methods in response to something the user did, such as a click.

Methods ​

goToSession(sessionId: string): Promise<void> ​

Show one of Omniscio's own sessions.

Parameters:

NameTypeDescription
sessionIdstringThe id of the session to show

Returns: Promise<void>


openTeamChat(uid: string): Promise<void> ​

Open the direct-message conversation with a teammate. This only opens the conversation. It sends nothing.

Parameters:

NameTypeDescription
uidstringThe teammate's user id

Returns: Promise<void>

Example ​

typescript
const omniscio = window.Omniscio ?? window.AgentMC

openButton.addEventListener('click', async () => {
  try {
    await omniscio.navigation.goToSession(row.sessionId)
  } catch {
    omniscio.toast.show({ type: 'error', message: 'Could not open that session.' })
  }
})

messageButton.addEventListener('click', () => omniscio.navigation.openTeamChat(teammateUid))

Notes ​

  • Webview only.
  • To get a session id to navigate to, create one with Sessions or read a granted one with Session History.
  • @omniscio/plugin-sdk/browser exports BridgeNavigation.

Omniscio Plugin SDK