Interface: GeminiNamespace

Defined in: gemini/src/builders/gemini-namespace-contract.ts:11

Builder namespace contract exported as gemini by @paraharness/gemini.

Provides entrypoints for declaring passive GeminiAccountSeatNode and GeminiModelNode AST descriptors without import-time or declaration-time side effects.

Methods

account()

account(id): GeminiAccountSeatBuilder;

Defined in: gemini/src/builders/gemini-namespace-contract.ts:23

Declares a Google Gemini API key or CLI/ADC account seat (type: 'gemini:account-seat').

Supports .apiKey(envRef) for API key seats and .configDir(path) for CLI/ADC seats.

Parameters

Parameter	Type	Description
id	string	Unique identifier for the Gemini account seat.

Returns

GeminiAccountSeatBuilder

Fluent builder for the Gemini account seat.

Throws

If id is an empty or whitespace-only string.

---

cliAccount()

cliAccount(id): GeminiAccountSeatBuilder;

Defined in: gemini/src/builders/gemini-namespace-contract.ts:36

Declares a Google Gemini CLI/ADC subscription seat (type: 'gemini:account-seat').

Alias for account(id) supporting .configDir(path) and .apiKey(envRef).

Parameters

Parameter	Type	Description
id	string	Unique identifier for the Gemini CLI seat.

Returns

GeminiAccountSeatBuilder

Fluent builder for the Gemini account seat.

Throws

If id is an empty or whitespace-only string.

---

model()

model(alias, options?): GeminiModelBuilder;

Defined in: gemini/src/builders/gemini-namespace-contract.ts:50

Declares a Google Gemini model configuration (type: 'gemini:model', vendor: 'google').

Supports .pool(pool) / .accountPool(pool) and .effort(level) before compiling to GeminiModelNode.

Parameters

Parameter	Type	Description
alias	string	Logical model alias (such as 'pro' or 'gemini-3.1-pro').
options?	GeminiModelOptions	Optional Gemini model identifier (defaults to alias) and thinking effort.

Returns

GeminiModelBuilder

Fluent builder for the Gemini model node.

Throws

If alias or options.id is an empty or whitespace-only string.