Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
import { createContext, useContext, useEffect } from 'react';
import type { InboxSession } from './ApiContext';
import type { UnreadByCategory } from '../lib/notificationPreferences';
// The Inbox state contract and the context handle every consumer reads.
// `WorkbenchInboxProvider.tsx` owns the feed, the SSE subscription and the
// writes; keeping the handle in its own component-free module lets the provider
// hot-reload on its own.
export interface InboxState {
/** Per-session ("Slack-like") feed: one card per conversation, newest
* activity first. Driven by realtime ``inbox.session.updated`` upserts. */
inboxSessions: InboxSession[];
/** Pagination-independent per-session unread counts — the sidebar badges
* each session row from this (a session with unread may sit past the first
* inbox page, so the feed array alone isn't a complete source). */
unreadBySession: Record<string, number>;
/** A whole-account unread snapshot has applied. Missing means unknown. */
unreadLoaded?: boolean;
/** Sum of ``unreadBySession`` — the Inbox nav badge. */
totalUnread: number;
/** Number of sessions with ≥1 unread reply — the header "N unread" count. */
unreadSessions: number;
/** ``totalUnread`` split into Bot conversations and ordinary Sessions. */
unreadByCategory: UnreadByCategory;
/** The aggregate badge: unread in categories whose notifications are on
* (docs/plans/workbench-refinements.md §1). The sidebar icon, the app icon and
* the tab favicon all show this; with every switch on it is ``totalUnread``. */
badgeTotal: number;
/** Keyset cursor for "load more"; null when the feed is fully loaded. */
nextCursor: string | null;
loading: boolean;
loadingMore: boolean;
refresh: () => Promise<void>;
loadMore: () => Promise<void>;
/** Resolves true when the server applied the read, false when it did not
* (errors are not raised: clearing unread is best-effort). */
markRead: (sessionId: string, untilMessageId?: string) => Promise<boolean>;
/** Refcounted activation for the FEED (see ``useConsumerActivation``). The
* unread map is unconditional — it badges the favicon and the app icon on
* every route — but ``inboxSessions`` is only rendered by the sidebar and the
* Inbox page, so the paged read waits for one of them. Consumers get this for
* free from ``useWorkbenchInbox``. */
activateFeed: () => () => void;
}
export const WorkbenchInboxContext = createContext<InboxState | undefined>(undefined);
/** Read the shared Inbox state.
*
* Pass ``feed: false`` when the component only reads the unread map (badges,
* a session's own dot) and never renders ``inboxSessions``. That is what keeps
* the 30-row page off routes that show no feed; declaring what you read, rather
* than which route you are on, is what keeps the rule true for a route added
* later. */
export const useWorkbenchInbox = (options?: { feed?: boolean }): InboxState => {
const ctx = useContext(WorkbenchInboxContext);
const feed = options?.feed ?? true;
const activateFeed = ctx?.activateFeed;
useEffect(() => {
if (!feed || !activateFeed) return;
return activateFeed();
}, [activateFeed, feed]);
if (ctx === undefined) {
throw new Error('useWorkbenchInbox must be used inside <WorkbenchInboxProvider>');
}
return ctx;
};