Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { IPC } from '../shared/ipc'
import {
MODEL_GATEWAY_SECRET_REF,
type ModelGatewaySettings
} from '../shared/agents/model-gateway'
import { registerAgentEnvIpc } from './agent-env-ipc'
import { ModelGatewayCredentialService } from './model-gateway-credentials'
import { fakePlatform, type FakePlatform } from './platform-fake'
import { initPlatform, resetPlatformForTests } from './platform'
describe('model gateway discovery API-key expansion', () => {
let fake: FakePlatform
let fetchMock: ReturnType<typeof vi.fn>
let inheritedKey: string | undefined
let credentials: ModelGatewayCredentialService
let storedKey: string | null
let savedGateway: ModelGatewaySettings | undefined
beforeEach(async () => {
inheritedKey = process.env.NODETERM_TEST_GATEWAY_KEY
fake = fakePlatform()
initPlatform(fake)
fetchMock = vi.fn().mockResolvedValue(
new Response(JSON.stringify({ data: [{ id: 'openai/gpt-5.5' }] }), {
status: 200,
headers: { 'content-type': 'application/json' }
})
)
vi.stubGlobal('fetch', fetchMock)
storedKey = null
credentials = new ModelGatewayCredentialService({
availability: 'encrypted',
readForHost: async () => storedKey,
save: async (value) => {
storedKey = value
},
clear: async () => {
storedKey = null
}
})
await credentials.init()
savedGateway = undefined
registerAgentEnvIpc(() => savedGateway, credentials)
})
afterEach(() => {
if (inheritedKey === undefined) delete process.env.NODETERM_TEST_GATEWAY_KEY
else process.env.NODETERM_TEST_GATEWAY_KEY = inheritedKey
vi.unstubAllGlobals()
resetPlatformForTests()
})
it('expands the key in core before authenticating model discovery', async () => {
process.env.NODETERM_TEST_GATEWAY_KEY = 'vk-from-env'
savedGateway = {
baseUrl: 'https://bifrost.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
}
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://bifrost.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
})
expect(result).toEqual({
models: [{ id: 'openai/gpt-5.5', provider: 'openai' }]
})
expect(fetchMock).toHaveBeenCalledWith(
'https://bifrost.example.test/v1/models',
expect.objectContaining({
headers: {
Authorization: 'Bearer vk-from-env',
'x-bf-vk': 'vk-from-env',
Accept: 'application/json'
}
})
)
})
it('does not make a request when the referenced variable is unset', async () => {
delete process.env.NODETERM_TEST_GATEWAY_KEY
savedGateway = {
baseUrl: 'https://bifrost.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
}
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://bifrost.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
})
expect(result).toEqual({
models: [],
error:
'Gateway API key environment variable is unset: ${env:NODETERM_TEST_GATEWAY_KEY}.'
})
expect(fetchMock).not.toHaveBeenCalled()
})
it('keeps a literal key write-only and uses it for discovery', async () => {
await expect(
fake.handlers[IPC.agentGatewayCredentialSave]('stored-gateway-key')
).resolves.toEqual({ hasStoredKey: true, storage: 'encrypted' })
savedGateway = { baseUrl: 'https://gateway.example.test', apiKey: MODEL_GATEWAY_SECRET_REF }
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://gateway.example.test',
apiKey: MODEL_GATEWAY_SECRET_REF
})
expect(result).toEqual({
models: [{ id: 'openai/gpt-5.5', provider: 'openai' }]
})
expect(fetchMock).toHaveBeenCalledWith(
'https://gateway.example.test/v1/models',
expect.objectContaining({
headers: {
Authorization: 'Bearer stored-gateway-key',
'x-bf-vk': 'stored-gateway-key',
Accept: 'application/json'
}
})
)
await expect(fake.handlers[IPC.agentGatewayCredentialClear]()).resolves.toEqual({
hasStoredKey: false,
storage: 'encrypted'
})
})
// ── The exfiltration-oracle gate ─────────────────────────────────────────────────────────────
// `platform().handle` answers relay peers and Server Edition WS clients, and the settings
// payload — baseUrl included — is caller-supplied. Without the gate, discovery would resolve
// the stored key (or ANY host env var) and send it as a bearer token to whatever URL the caller
// named. These tests prove the refusal happens BEFORE any request is made.
it('REFUSES to send the stored key to a caller-chosen URL', async () => {
await fake.handlers[IPC.agentGatewayCredentialSave]('stored-gateway-key')
savedGateway = { baseUrl: 'https://gateway.example.test', apiKey: MODEL_GATEWAY_SECRET_REF }
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://attacker.example.test',
apiKey: MODEL_GATEWAY_SECRET_REF
})
expect(result).toEqual({
models: [],
error:
'Stored or environment API keys are only sent to the saved gateway URL — save the gateway settings first.'
})
expect(fetchMock).not.toHaveBeenCalled()
})
it('REFUSES to resolve an env-var reference for a caller-chosen URL', async () => {
process.env.NODETERM_TEST_GATEWAY_KEY = 'vk-from-env'
savedGateway = { baseUrl: 'https://gateway.example.test', apiKey: MODEL_GATEWAY_SECRET_REF }
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://attacker.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
})
expect(result).toMatchObject({ models: [] })
expect(fetchMock).not.toHaveBeenCalled()
})
it('REFUSES references when no gateway has been saved at all', async () => {
process.env.NODETERM_TEST_GATEWAY_KEY = 'vk-from-env'
savedGateway = undefined
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://bifrost.example.test',
apiKey: '${env:NODETERM_TEST_GATEWAY_KEY}'
})
expect(result).toMatchObject({ models: [] })
expect(fetchMock).not.toHaveBeenCalled()
})
it('still tests a LITERAL key against an unsaved URL (the pre-save Settings flow)', async () => {
savedGateway = undefined
const result = await fake.handlers[IPC.agentDiscoverModels]({
baseUrl: 'https://new-gateway.example.test',
apiKey: 'vk-typed-into-the-form'
})
expect(result).toEqual({ models: [{ id: 'openai/gpt-5.5', provider: 'openai' }] })
expect(fetchMock).toHaveBeenCalledWith(
'https://new-gateway.example.test/v1/models',
expect.objectContaining({
headers: expect.objectContaining({ Authorization: 'Bearer vk-typed-into-the-form' })
})
)
})
})