@ottocode/sdk 0.1.244 → 0.1.246

package/src/core/src/utils/debug.ts

@@ -6,6 +6,9 @@ type DebugSettings = {
 	debugScopes?: unknown;
 };
 
+let debugEnabledOverride: boolean | undefined;
+let traceEnabledOverride: boolean | undefined;
+
 function readDebugSettings(): DebugSettings {
 	try {
 		const raw = readFileSync(getGlobalConfigPath(), 'utf-8');
@@ -17,13 +20,23 @@ function readDebugSettings(): DebugSettings {
 }
 
 export function isDebugEnabled(): boolean {
+	if (debugEnabledOverride !== undefined) return debugEnabledOverride;
 	return readDebugSettings().debugEnabled === true;
 }
 
 export function isTraceEnabled(): boolean {
+	if (traceEnabledOverride !== undefined) return traceEnabledOverride;
 	return false;
 }
 
+export function setDebugEnabled(enabled: boolean): void {
+	debugEnabledOverride = enabled;
+}
+
+export function setTraceEnabled(enabled: boolean): void {
+	traceEnabledOverride = enabled;
+}
+
 export function getDebugScopes(): string[] {
 	const scopes = readDebugSettings().debugScopes;
 	if (!Array.isArray(scopes)) return [];

package/src/index.ts

@@ -14,7 +14,10 @@
 // =======================
 // Provider types
 export type {
+	BuiltInProviderId,
 	ProviderId,
+	ProviderCompatibility,
+	ProviderPromptFamily,
 	ModelOwner,
 	ModelInfo,
 	ModelProviderBinding,
@@ -28,6 +31,7 @@ export type { ApiAuth, OAuth, AuthInfo, AuthFile } from './types/src/index.ts';
 export type {
 	DefaultConfig,
 	PathConfig,
+	ProviderSettingsEntry,
 	OttoConfig,
 	ReasoningLevel,
 } from './types/src/index.ts';
@@ -51,6 +55,29 @@ export {
 	modelSupportsReasoning,
 } from './providers/src/index.ts';
 export type { UnderlyingProviderKey } from './providers/src/index.ts';
+export {
+	discoverOllamaModels,
+	normalizeOllamaBaseURL,
+} from './providers/src/index.ts';
+export type {
+	DiscoverOllamaOptions,
+	DiscoverOllamaResult,
+} from './providers/src/index.ts';
+export {
+	isBuiltInProviderId,
+	getProviderSettings,
+	getProviderDefinition,
+	hasConfiguredProvider,
+	getConfiguredProviderIds,
+	getConfiguredProviderModels,
+	getConfiguredProviderDefaultModel,
+	providerAllowsAnyModel,
+	hasConfiguredModel,
+	getConfiguredProviderFamily,
+	getConfiguredProviderEnvVar,
+	getConfiguredProviderApiKey,
+} from './providers/src/index.ts';
+export type { ResolvedProviderDefinition } from './providers/src/index.ts';
 export {
 	isProviderAuthorized,
 	ensureProviderEnv,
@@ -63,20 +90,20 @@ export {
 	setEnvKey,
 } from './providers/src/index.ts';
 export {
-	createSetu,
-	createSetuFetch,
-	createSetuModel,
-	fetchSetuBalance,
+	createOttoRouter,
+	createOttoRouterFetch,
+	createOttoRouterModel,
+	fetchOttoRouterBalance,
 	getPublicKeyFromPrivate,
 	fetchSolanaUsdcBalance,
 } from './providers/src/index.ts';
 export type {
-	SetuAuth,
-	SetuInstance,
-	SetuProviderOptions,
-	SetuPaymentCallbacks,
-	SetuBalanceUpdate,
-	SetuBalanceResponse,
+	OttoRouterAuth,
+	OttoRouterInstance,
+	OttoRouterProviderOptions,
+	OttoRouterPaymentCallbacks,
+	OttoRouterBalanceUpdate,
+	OttoRouterBalanceResponse,
 	SolanaUsdcBalanceResponse,
 } from './providers/src/index.ts';
 export {
@@ -150,8 +177,8 @@ export {
 	generateWallet,
 	importWallet,
 	isValidPrivateKey,
-	getSetuWallet,
-	ensureSetuWallet,
+	getOttoRouterWallet,
+	ensureOttoRouterWallet,
 } from './auth/src/index.ts';
 export type { WalletInfo } from './auth/src/index.ts';
 export {
@@ -193,6 +220,9 @@ export {
 	isAuthorized,
 	ensureEnv,
 	writeDefaults as setConfig,
+	writeProviderSettings,
+	removeProviderSettings,
+	writeSkillSettings,
 	readDebugConfig,
 	writeDebugConfig,
 	writeAuth,
@@ -290,6 +320,8 @@ export {
 	time,
 	isDebugEnabled,
 	isTraceEnabled,
+	setDebugEnabled,
+	setTraceEnabled,
 } from './core/src/index.ts';
 
 // Schema Validation
@@ -337,8 +369,11 @@ export {
 export {
 	initializeSkills,
 	getDiscoveredSkills,
+	setSkillSettings,
+	filterDiscoveredSkills,
 	isSkillsInitialized,
 	buildSkillTool,
+	summarizeDescription,
 	rebuildSkillDescription,
 } from './skills/index.ts';
 

package/src/prompts/src/agents/build.txt

@@ -8,10 +8,9 @@ You help with coding and build tasks.
 
 Pick the right tool for the job (each tool's description has its full contract):
 
-- `edit` — one exact replacement in an existing file.
-- `multiedit` — several exact replacements in the same file.
-- `apply_patch` — structural diffs, file add/delete/rename, or multi-file changes awkward as exact replacements.
-- `write` — NEW files only, or >70% full-file rewrites. Never for targeted edits.
+- Use the exact-replacement editing tools available to you for targeted changes in existing files.
+- Use patch-style editing for structural diffs, file add/delete/rename, or multi-file changes when that capability is available.
+- Use `write` only for NEW files or >70% full-file rewrites. Never use it for targeted edits.
 
 **Always read a file immediately before editing it.** Memory and earlier context are not reliable — the file may have changed.
 

package/src/prompts/src/providers/default.txt

@@ -26,7 +26,7 @@ You are a coding agent running in otto, a terminal-based coding assistant. Preci
 
 1. Understand — use `glob`, `ripgrep`, `tree`, `read` to map the code. Batch independent searches.
 2. Plan — use `update_todos` for multi-step work. Mark one step `in_progress` at a time.
-3. Implement — prefer `edit` / `multiedit` for targeted changes; use `apply_patch` for structural or multi-file edits; use `write` only for new files or near-total rewrites.
+3. Implement — prefer the targeted editing tools available to you for small in-file changes; use patch-style edits for structural or multi-file changes when available; use `write` only for new files or near-total rewrites.
 4. Verify — run project-specific build/lint/test commands via `bash`. Check `README.md` / `AGENTS.md` for the right command.
 5. Review — `git_status` / `git_diff`. Do NOT commit unless asked.
 

package/src/prompts/src/providers/glm.txt

@@ -38,7 +38,7 @@ Your reasoning is powerful, but it can override what you actually read. Guard ag
 
 1. Understand — use `glob`, `ripgrep`, `tree`, `read` to map the code. Batch independent searches.
 2. Plan — use `update_todos` for multi-step work. Mark one step `in_progress` at a time.
-3. Implement — prefer `edit` / `multiedit` for targeted changes; use `apply_patch` for structural or multi-file edits; use `write` only for new files or near-total rewrites.
+3. Implement — prefer the targeted editing tools available to you for small in-file changes; use patch-style edits for structural or multi-file changes when available; use `write` only for new files or near-total rewrites.
 4. Verify — run project-specific build/lint/test commands via `bash`. Check `README.md` / `AGENTS.md` for the right command.
 5. Review — `git_status` / `git_diff`. Do NOT commit unless asked.
 

package/src/prompts/src/providers/google.txt

@@ -21,7 +21,7 @@ For bug fixes, features, refactors, or explanations:
 
 1. **Understand.** Use `glob` / `ripgrep` / `tree` / `read` extensively (in parallel when independent) to understand structure, patterns, and conventions.
 2. **Plan.** Build a grounded plan. Share an extremely concise plan with the user if it helps. Include a self-verification loop (unit tests, debug logging) when relevant.
-3. **Implement.** Use `edit`, `multiedit`, `apply_patch`, `write`, `bash` — strictly adhering to Core Mandates.
+3. **Implement.** Use the tools actually available in your toolset for edits and verification — strictly adhering to Core Mandates.
 4. **Verify (tests).** Identify test commands from `README`, `package.json`, or existing test patterns. NEVER assume standard test commands.
 5. **Verify (standards).** Run the project's build, linter, and type-checker (e.g. `tsc`, `npm run lint`, `ruff check .`). If unsure, ask the user.
 
@@ -103,7 +103,7 @@ Here's the plan:
 Should I proceed?
 user: Yes
 model:
-[tool_call: edit, multiedit, write, or apply_patch to apply the refactoring to 'src/auth.py']
+[tool_call: use the appropriate available file-editing tool to apply the refactoring to 'src/auth.py']
 Refactoring complete. Running verification...
 [tool_call: bash for 'ruff check src/auth.py && pytest']
 (After verification passes)

package/src/prompts/src/providers/moonshot.txt

@@ -38,7 +38,7 @@ Your reasoning is powerful, but it can override what you actually read. Guard ag
 
 1. Understand — use `glob`, `ripgrep`, `tree`, `read` to map the code. Batch independent searches.
 2. Plan — use `update_todos` for multi-step work. Mark one step `in_progress` at a time.
-3. Implement — prefer `edit` / `multiedit` for targeted changes; use `apply_patch` for structural or multi-file edits; use `write` only for new files or near-total rewrites.
+3. Implement — prefer the targeted editing tools available to you for small in-file changes; use patch-style edits for structural or multi-file changes when available; use `write` only for new files or near-total rewrites.
 4. Verify — run project-specific build/lint/test commands via `bash`. Check `README.md` / `AGENTS.md` for the right command.
 5. Review — `git_status` / `git_diff`. Do NOT commit unless asked.
 

package/src/prompts/src/providers/openai.txt

@@ -74,7 +74,7 @@ Criteria when solving queries:
 - Working on repos in the current environment is allowed, even proprietary ones.
 - Analyzing code for vulnerabilities is allowed.
 - Showing user code and tool call details is allowed.
-- For targeted edits in existing files, prefer `edit` and `multiedit`. For structural diffs or file add/delete/rename, use `apply_patch`.
+- For code edits, prefer the targeted editing tools you actually have. Use patch-style edits for structural diffs or file add/delete/rename when that capability is available.
 
 Code guidelines (AGENTS.md may override):
 
@@ -85,7 +85,7 @@ Code guidelines (AGENTS.md may override):
 - Keep changes consistent with existing codebase style; minimal and focused.
 - Use `git log` / `git blame` to search history when needed.
 - NEVER add copyright or license headers unless asked.
-- Do NOT re-read files after `apply_patch` — the call fails if it didn't work.
+- Do NOT re-read files after a successful patch-style edit — the call fails if it didn't work.
 - Do NOT `git commit` or create branches unless explicitly requested.
 - Do NOT add inline comments within code unless asked.
 - Do NOT use one-letter variable names unless asked.
@@ -120,7 +120,7 @@ Read like an update from a concise teammate. For casual conversation, brainstorm
 
 For finished substantive work, follow the formatting guidelines below. Skip heavy formatting for simple actions or confirmations. Reserve multi-section responses for results that need grouping.
 
-The user has access to your work. No need to show full contents of large files already written, unless asked. After `apply_patch`, don't tell users to "save the file" — just reference the path.
+The user has access to your work. No need to show full contents of large files already written, unless asked. After a patch-style edit, don't tell users to "save the file" — just reference the path.
 
 If there's a logical next step you could help with, concisely ask. Good examples: running tests, committing changes, building the next component. If there's something you couldn't do but the user might want to (like verifying changes by running the app), include instructions succinctly.
 

package/src/prompts/src/providers.ts

@@ -3,6 +3,7 @@ import {
 	getModelInfo,
 	isProviderId,
 } from '../../providers/src/utils.ts';
+import type { ProviderPromptFamily } from '../../types/src/index.ts';
 import type { UnderlyingProviderKey } from '../../providers/src/utils.ts';
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
 import PROVIDER_OPENAI from './providers/openai.txt' with { type: 'text' };
@@ -40,6 +41,14 @@ function promptForFamily(family: UnderlyingProviderKey): string {
 	return (FAMILY_PROMPTS[family] ?? PROVIDER_DEFAULT).trim();
 }
 
+function promptForCustomFamily(
+	family: ProviderPromptFamily | undefined,
+): string {
+	if (!family || family === 'default') return PROVIDER_DEFAULT.trim();
+	if (family === 'openai-compatible') return PROVIDER_DEFAULT.trim();
+	return (FAMILY_PROMPTS[family] ?? PROVIDER_DEFAULT).trim();
+}
+
 async function readIfExists(path: string): Promise<string | undefined> {
 	try {
 		const f = Bun.file(path);
@@ -76,6 +85,7 @@ export async function providerBasePrompt(
 	provider: string,
 	modelId: string | undefined,
 	projectRoot: string,
+	customFamily?: ProviderPromptFamily,
 ): Promise<ProviderPromptResult> {
 	const id = String(provider || '').toLowerCase();
 	const { modelPaths, providerPaths } = getPromptOverridePaths({
@@ -100,6 +110,11 @@ export async function providerBasePrompt(
 		return { prompt: providerText, resolvedType: `custom:${id}` };
 	}
 
+	if (!isProviderId(id) && customFamily) {
+		const result = promptForCustomFamily(customFamily);
+		return { prompt: result, resolvedType: customFamily };
+	}
+
 	if (isProviderId(id) && modelId) {
 		const info = getModelInfo(id, modelId);
 		if (info?.ownedBy) {

package/src/providers/src/authorization.ts

@@ -4,14 +4,39 @@ import {
 } from '../../config/src/index.ts';
 import type { OttoConfig } from '../../config/src/index.ts';
 import type { ProviderId } from '../../types/src/index.ts';
+import {
+	getConfiguredProviderApiKey,
+	getConfiguredProviderEnvVar,
+	getProviderDefinition,
+	isBuiltInProviderId,
+} from './registry.ts';
 
 export async function isProviderAuthorized(
 	cfg: OttoConfig,
 	provider: ProviderId,
 ) {
+	const definition = getProviderDefinition(cfg, provider);
+	if (!definition) return false;
+	if (
+		definition.source === 'custom' &&
+		cfg.providers[String(provider)]?.enabled === false
+	)
+		return false;
+	if (getConfiguredProviderApiKey(cfg, provider)) return true;
+	if (definition.apiKeyEnv && process.env[definition.apiKeyEnv]) return true;
+	if (!isBuiltInProviderId(provider)) {
+		return !definition.apiKeyEnv && !cfg.providers[String(provider)]?.apiKey;
+	}
 	return await mgrIsAuthorized(provider, cfg.projectRoot);
 }
 
 export async function ensureProviderEnv(cfg: OttoConfig, provider: ProviderId) {
-	await mgrEnsureEnv(provider, cfg.projectRoot);
+	const envVar = getConfiguredProviderEnvVar(cfg, provider);
+	const apiKey = getConfiguredProviderApiKey(cfg, provider);
+	if (envVar && apiKey && !process.env[envVar]) {
+		process.env[envVar] = apiKey;
+	}
+	if (isBuiltInProviderId(provider)) {
+		await mgrEnsureEnv(provider, cfg.projectRoot);
+	}
 }

package/src/providers/src/catalog-manual.ts

@@ -1,14 +1,18 @@
-import { setuCatalog, type SetuModelCatalogEntry } from '@ottocode/ai-sdk';
+import {
+	ottorouterCatalog,
+	type OttoRouterModelCatalogEntry,
+} from '@ottorouter/ai-sdk';
 import type {
+	BuiltInProviderId,
 	ModelInfo,
 	ModelOwner,
 	ProviderCatalogEntry,
-	ProviderId,
 } from '../../types/src/index.ts';
 
-type CatalogMap = Partial<Record<ProviderId, ProviderCatalogEntry>>;
+type CatalogMap = Partial<Record<BuiltInProviderId, ProviderCatalogEntry>>;
 
-const SETU_ID: ProviderId = 'setu';
+const OLLAMA_CLOUD_ID: BuiltInProviderId = 'ollama-cloud';
+const OTTOROUTER_ID: BuiltInProviderId = 'ottorouter';
 
 const OWNER_NPM: Record<ModelOwner, string> = {
 	openai: '@ai-sdk/openai',
@@ -21,7 +25,7 @@ const OWNER_NPM: Record<ModelOwner, string> = {
 	minimax: '@ai-sdk/anthropic',
 };
 
-function convertSetuModel(m: SetuModelCatalogEntry): ModelInfo {
+function convertOttoRouterModel(m: OttoRouterModelCatalogEntry): ModelInfo {
 	const ownedBy = m.owned_by as ModelOwner;
 	return {
 		id: m.id,
@@ -52,12 +56,12 @@ function convertSetuModel(m: SetuModelCatalogEntry): ModelInfo {
 	};
 }
 
-function buildSetuEntry(): ProviderCatalogEntry | null {
-	const setuModels = setuCatalog.models.map(convertSetuModel);
+function buildOttoRouterEntry(): ProviderCatalogEntry | null {
+	const ottorouterModels = ottorouterCatalog.models.map(convertOttoRouterModel);
 
-	if (!setuModels.length) return null;
+	if (!ottorouterModels.length) return null;
 
-	setuModels.sort((a, b) => {
+	ottorouterModels.sort((a, b) => {
 		const ownerA = a.ownedBy ?? '';
 		const ownerB = b.ownedBy ?? '';
 		if (ownerA === ownerB) {
@@ -69,31 +73,45 @@ function buildSetuEntry(): ProviderCatalogEntry | null {
 	});
 
 	const defaultModelId = 'gpt-5-codex';
-	const defaultIdx = setuModels.findIndex((m) => m.id === defaultModelId);
+	const defaultIdx = ottorouterModels.findIndex((m) => m.id === defaultModelId);
 	if (defaultIdx > 0) {
-		const [picked] = setuModels.splice(defaultIdx, 1);
-		setuModels.unshift(picked);
+		const [picked] = ottorouterModels.splice(defaultIdx, 1);
+		ottorouterModels.unshift(picked);
 	}
 
 	return {
-		id: SETU_ID,
-		label: 'Setu',
-		env: ['SETU_PRIVATE_KEY'],
-		api: 'https://setu.ottocode.io/v1',
-		doc: 'https://setu.ottocode.io/docs',
-		models: setuModels,
+		id: OTTOROUTER_ID,
+		label: 'OttoRouter',
+		env: ['OTTOROUTER_PRIVATE_KEY'],
+		api: 'https://api.ottorouter.org/v1',
+		doc: 'https://ottorouter.org/docs',
+		models: ottorouterModels,
+	};
+}
+
+function buildOllamaCloudEntry(): ProviderCatalogEntry {
+	return {
+		id: OLLAMA_CLOUD_ID,
+		label: 'Ollama Cloud',
+		env: ['OLLAMA_API_KEY'],
+		npm: 'ai-sdk-ollama',
+		api: 'https://ollama.com',
+		doc: 'https://docs.ollama.com/cloud',
+		models: [],
 	};
 }
 
 export function mergeManualCatalog(
 	base: CatalogMap,
-): Record<ProviderId, ProviderCatalogEntry> {
-	const manualEntry = buildSetuEntry();
-	const merged: Record<ProviderId, ProviderCatalogEntry> = {
-		...(base as Record<ProviderId, ProviderCatalogEntry>),
+): Record<BuiltInProviderId, ProviderCatalogEntry> {
+	const ollamaCloudEntry = buildOllamaCloudEntry();
+	const manualEntry = buildOttoRouterEntry();
+	const merged: Record<BuiltInProviderId, ProviderCatalogEntry> = {
+		...(base as Record<BuiltInProviderId, ProviderCatalogEntry>),
 	};
+	merged[OLLAMA_CLOUD_ID] = ollamaCloudEntry;
 	if (manualEntry) {
-		merged[SETU_ID] = manualEntry;
+		merged[OTTOROUTER_ID] = manualEntry;
 	}
 	return merged;
 }

package/src/providers/src/catalog-merged.ts

@@ -1,9 +1,9 @@
 import type {
+	BuiltInProviderId,
 	ProviderCatalogEntry,
-	ProviderId,
 } from '../../types/src/index.ts';
 import { catalog as generatedCatalog } from './catalog.ts';
 import { mergeManualCatalog } from './catalog-manual.ts';
 
-export const catalog: Record<ProviderId, ProviderCatalogEntry> =
+export const catalog: Record<BuiltInProviderId, ProviderCatalogEntry> =
 	mergeManualCatalog(generatedCatalog);