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
export type InstanceRole = 'owner' | 'member' | 'editor' | 'viewer';
export type InstanceCapabilities = {
is_instance_owner: boolean;
can_read_instance: boolean;
can_chat: boolean;
can_manage_projects: boolean;
can_manage_agents: boolean;
can_manage_instance: boolean;
can_manage_access_members: boolean;
can_use_agents: boolean;
can_use_skills: boolean;
can_use_vault_secrets: boolean;
can_use_show_pages: boolean;
can_use_terminal_files: boolean;
can_use_terminal: boolean;
can_use_files: boolean;
can_use_system: boolean;
};
export type InstanceKind = 'personal' | 'organization';
export type RemoteAuthorizationState = 'current' | 'revoked' | 'unavailable';
export type SessionInfo =
| {
remote: false;
instance_kind: InstanceKind | null;
instance_role?: 'owner';
capabilities?: InstanceCapabilities;
author_id?: string | null;
}
| { remote: true; authenticated: false; authorization_refresh_required?: boolean }
| {
remote: true;
authenticated: true;
email: string;
sub?: string;
instance_kind: InstanceKind | null;
authorization_state: 'revoked' | 'unavailable';
}
| {
remote: true;
authenticated: true;
email: string;
sub?: string;
instance_kind: InstanceKind | null;
instance_role: InstanceRole;
capabilities: InstanceCapabilities;
authorization_state: 'current';
author_id?: string | null;
};
export const DENIED_INSTANCE_CAPABILITIES: InstanceCapabilities = {
is_instance_owner: false,
can_read_instance: false,
can_chat: false,
can_manage_projects: false,
can_manage_agents: false,
can_manage_instance: false,
can_manage_access_members: false,
can_use_agents: false,
can_use_skills: false,
can_use_vault_secrets: false,
can_use_show_pages: false,
can_use_terminal_files: false,
can_use_terminal: false,
can_use_files: false,
can_use_system: false,
};
export const OWNER_INSTANCE_CAPABILITIES: InstanceCapabilities = Object.fromEntries(
Object.keys(DENIED_INSTANCE_CAPABILITIES).map((key) => [key, true]),
) as InstanceCapabilities;
export const canCreateLocalProject = (capabilities: InstanceCapabilities): boolean =>
capabilities.can_manage_projects && capabilities.can_use_files;
const isRecord = (value: unknown): value is Record<string, unknown> =>
typeof value === 'object' && value !== null && !Array.isArray(value);
const normalizeCapabilities = (value: Record<string, unknown>): InstanceCapabilities =>
Object.fromEntries(
Object.keys(DENIED_INSTANCE_CAPABILITIES).map((key) => [key, value[key] === true]),
) as InstanceCapabilities;
const normalizeInstanceKind = (value: unknown): InstanceKind | null =>
value === 'personal' || value === 'organization' ? value : null;
// The principal the server writes this browser's Chat rows as, or nothing.
const authorIdField = (value: unknown): { author_id?: string } =>
typeof value === 'string' && value.trim() ? { author_id: value.trim() } : {};
export const normalizeSessionInfo = (value: unknown): SessionInfo => {
if (!isRecord(value)) return { remote: true, authenticated: false };
if (value.remote === false) {
return {
remote: false,
instance_kind: normalizeInstanceKind(value.instance_kind),
instance_role: 'owner',
capabilities: OWNER_INSTANCE_CAPABILITIES,
...authorIdField(value.author_id),
};
}
if (value.remote !== true || value.authenticated !== true) {
return {
remote: true,
authenticated: false,
...(value.authorization_refresh_required === true
? { authorization_refresh_required: true }
: {}),
};
}
if (value.authorization_state === 'revoked' || value.authorization_state === 'unavailable') {
return {
remote: true,
authenticated: true,
email: typeof value.email === 'string' ? value.email : '',
...(typeof value.sub === 'string' ? { sub: value.sub } : {}),
instance_kind: normalizeInstanceKind(value.instance_kind),
authorization_state: value.authorization_state,
};
}
const rawCapabilities = isRecord(value.capabilities) ? value.capabilities : null;
// Releases before instance roles treated every authenticated remote user as
// the instance owner and did not return a capabilities object.
const capabilities = rawCapabilities
? normalizeCapabilities(rawCapabilities)
: OWNER_INSTANCE_CAPABILITIES;
const instanceRole =
value.instance_role === 'owner' ||
value.instance_role === 'member' ||
value.instance_role === 'editor' ||
value.instance_role === 'viewer'
? value.instance_role
: rawCapabilities && !capabilities.is_instance_owner
? 'viewer'
: 'owner';
return {
remote: true,
authenticated: true,
email: typeof value.email === 'string' ? value.email : '',
...(typeof value.sub === 'string' ? { sub: value.sub } : {}),
instance_kind: normalizeInstanceKind(value.instance_kind),
instance_role: instanceRole,
capabilities,
authorization_state: 'current',
...authorIdField(value.author_id),
};
};