@ottocode/sdk 0.1.173

package/src/config/src/manager.ts

@@ -0,0 +1,181 @@
+import { loadConfig } from './index.ts';
+import {
+	getAllAuth,
+	setAuth as setAuthFile,
+	removeAuth as removeAuthFile,
+	type ProviderId,
+	type AuthInfo,
+} from '../../auth/src/index.ts';
+import {
+	getGlobalConfigDir,
+	getGlobalConfigPath,
+	getLocalDataDir,
+	joinPath,
+} from './paths.ts';
+import {
+	providerIds,
+	readEnvKey,
+	setEnvKey,
+} from '../../providers/src/index.ts';
+
+export type Scope = 'global' | 'local';
+
+export async function read(projectRoot?: string) {
+	const cfg = await loadConfig(projectRoot);
+	const auth = await getAllAuth(projectRoot);
+	return { cfg, auth };
+}
+
+export async function isAuthorized(
+	provider: ProviderId,
+	projectRoot?: string,
+): Promise<boolean> {
+	if (!providerIds.includes(provider)) return false;
+	if (readEnvKey(provider)) return true;
+	const { auth } = await read(projectRoot);
+	const info = auth[provider];
+	if (info?.type === 'api' && info.key) return true;
+	if (info?.type === 'oauth' && info.refresh && info.access) return true;
+	if (info?.type === 'wallet' && info.secret) return true;
+	return false;
+}
+
+export async function ensureEnv(
+	provider: ProviderId,
+	projectRoot?: string,
+): Promise<void> {
+	if (!providerIds.includes(provider)) return;
+	if (readEnvKey(provider)) return;
+	const { auth } = await read(projectRoot);
+	const stored = auth[provider];
+	const value =
+		stored?.type === 'api'
+			? stored.key
+			: stored?.type === 'wallet'
+				? stored.secret
+				: undefined;
+	if (value) setEnvKey(provider, value);
+}
+
+export async function writeDefaults(
+	scope: Scope,
+	updates: Partial<{
+		agent: string;
+		provider: ProviderId;
+		model: string;
+		toolApproval: 'auto' | 'dangerous' | 'all';
+	}>,
+	projectRoot?: string,
+) {
+	const root = projectRoot ? String(projectRoot) : process.cwd();
+
+	if (scope === 'local') {
+		const localDir = getLocalDataDir(root);
+		const localPath = joinPath(localDir, 'config.json');
+		const existing = await readJsonFile(localPath);
+		const prevDefaults =
+			existing && typeof existing.defaults === 'object'
+				? (existing.defaults as Record<string, unknown>)
+				: {};
+		const next = {
+			...existing,
+			defaults: { ...prevDefaults, ...updates },
+		};
+		try {
+			const { promises: fs } = await import('node:fs');
+			await fs.mkdir(localDir, { recursive: true }).catch(() => {});
+		} catch {}
+		await Bun.write(localPath, JSON.stringify(next, null, 2));
+		return;
+	}
+
+	const globalPath = getGlobalConfigPath();
+	const existing = await readJsonFile(globalPath);
+	const prevDefaults =
+		existing && typeof existing.defaults === 'object'
+			? (existing.defaults as Record<string, unknown>)
+			: {};
+	const next = {
+		...existing,
+		defaults: { ...prevDefaults, ...updates },
+	};
+	const base = getGlobalConfigDir();
+	try {
+		const { promises: fs } = await import('node:fs');
+		await fs.mkdir(base, { recursive: true }).catch(() => {});
+	} catch {}
+	await Bun.write(globalPath, JSON.stringify(next, null, 2));
+}
+
+async function readJsonFile(
+	filePath: string,
+): Promise<Record<string, unknown> | undefined> {
+	const f = Bun.file(filePath);
+	if (!(await f.exists())) return undefined;
+	try {
+		const parsed = await f.json();
+		if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+			return parsed as Record<string, unknown>;
+		}
+		return undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+export async function writeAuth(
+	provider: ProviderId,
+	info: AuthInfo,
+	scope: Scope = 'global',
+	projectRoot?: string,
+) {
+	await setAuthFile(provider, info, projectRoot, scope);
+}
+
+export async function removeAuth(
+	provider: ProviderId,
+	scope: Scope = 'global',
+	projectRoot?: string,
+) {
+	await removeAuthFile(provider, projectRoot, scope);
+}
+
+export async function getOnboardingComplete(
+	_projectRoot?: string,
+): Promise<boolean> {
+	const globalPath = getGlobalConfigPath();
+	const f = Bun.file(globalPath);
+	if (await f.exists()) {
+		try {
+			const data = await f.json();
+			return data?.onboardingComplete === true;
+		} catch {
+			return false;
+		}
+	}
+	return false;
+}
+
+export async function setOnboardingComplete(
+	_projectRoot?: string,
+): Promise<void> {
+	const globalPath = getGlobalConfigPath();
+	const base = getGlobalConfigDir();
+
+	let existing: Record<string, unknown> = {};
+	const f = Bun.file(globalPath);
+	if (await f.exists()) {
+		try {
+			existing = (await f.json()) as Record<string, unknown>;
+		} catch {}
+	}
+
+	const next = { ...existing, onboardingComplete: true };
+
+	try {
+		const { promises: fs } = await import('node:fs');
+		await fs.mkdir(base, { recursive: true }).catch(() => {});
+	} catch {}
+
+	await Bun.write(globalPath, JSON.stringify(next, null, 2));
+}

package/src/config/src/paths.ts

@@ -0,0 +1,98 @@
+// Utilities for resolving otto config/data paths consistently
+// Uses XDG base directory spec for global config: ~/.config/otto by default
+
+// Minimal path join to avoid node:path; ensures forward slashes
+function joinPath(...parts: string[]) {
+	return parts
+		.filter(Boolean)
+		.map((p) => p.replace(/\\/g, '/'))
+		.join('/')
+		.replace(/\/+\/+/g, '/');
+}
+
+export function getHomeDir(): string {
+	return (process.env.HOME || process.env.USERPROFILE || '').replace(
+		/\\/g,
+		'/',
+	);
+}
+
+export function getConfigHomeDir(): string {
+	const cfgHome = process.env.XDG_CONFIG_HOME;
+	if (cfgHome?.trim()) return cfgHome.replace(/\\/g, '/');
+	return joinPath(getHomeDir(), '.config');
+}
+
+export function getGlobalConfigDir(): string {
+	return joinPath(getConfigHomeDir(), 'otto');
+}
+
+export function getGlobalConfigPath(): string {
+	return joinPath(getGlobalConfigDir(), 'config.json');
+}
+
+export function getGlobalAuthPath(): string {
+	return joinPath(getGlobalConfigDir(), 'auth.json');
+}
+
+// Secure location for auth secrets (not in config dir or project)
+// - Linux: $XDG_STATE_HOME/otto/auth.json or ~/.local/state/otto/auth.json
+// - macOS: ~/Library/Application Support/otto/auth.json
+// - Windows: %APPDATA%\otto\auth.json
+export function getSecureAuthPath(): string {
+	const platform = process.platform;
+	if (platform === 'darwin') {
+		return joinPath(
+			getHomeDir(),
+			'Library',
+			'Application Support',
+			'otto',
+			'auth.json',
+		);
+	}
+	if (platform === 'win32') {
+		const appData = (process.env.APPDATA || '').replace(/\\/g, '/');
+		const base = appData || joinPath(getHomeDir(), 'AppData', 'Roaming');
+		return joinPath(base, 'otto', 'auth.json');
+	}
+	const stateHome = (process.env.XDG_STATE_HOME || '').replace(/\\/g, '/');
+	const base = stateHome || joinPath(getHomeDir(), '.local', 'state');
+	return joinPath(base, 'otto', 'auth.json');
+}
+
+// Global content under config dir
+export function getGlobalAgentsJsonPath(): string {
+	return joinPath(getGlobalConfigDir(), 'agents.json');
+}
+
+export function getGlobalAgentsDir(): string {
+	return joinPath(getGlobalConfigDir(), 'agents');
+}
+
+export function getGlobalToolsDir(): string {
+	return joinPath(getGlobalConfigDir(), 'tools');
+}
+
+export function getGlobalCommandsDir(): string {
+	return joinPath(getGlobalConfigDir(), 'commands');
+}
+
+export function getLocalDataDir(projectRoot: string): string {
+	return joinPath(projectRoot, '.otto');
+}
+
+export async function ensureDir(dir: string) {
+	try {
+		// Attempt to create a marker file to ensure directory exists
+		await Bun.write(joinPath(dir, '.keep'), '');
+	} catch {
+		const { promises: fs } = await import('node:fs');
+		await fs.mkdir(dir, { recursive: true }).catch(() => {});
+	}
+}
+
+export async function fileExists(p: string) {
+	return await Bun.file(p).exists();
+}
+
+export { joinPath };

package/src/core/src/errors.ts

@@ -0,0 +1,102 @@
+/**
+ * Base error class for all otto errors
+ */
+export class OttoError extends Error {
+	constructor(
+		message: string,
+		public readonly code: string,
+		public readonly status: number = 500,
+		public readonly details?: Record<string, unknown>,
+	) {
+		super(message);
+		this.name = this.constructor.name;
+		Error.captureStackTrace(this, this.constructor);
+	}
+
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message,
+			code: this.code,
+			status: this.status,
+			details: this.details,
+		};
+	}
+}
+
+/**
+ * Authentication and authorization errors
+ */
+export class AuthError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'AUTH_ERROR', 401, details);
+	}
+}
+
+/**
+ * Configuration errors
+ */
+export class ConfigError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'CONFIG_ERROR', 500, details);
+	}
+}
+
+/**
+ * Tool execution errors
+ */
+export class ToolError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'TOOL_ERROR', 500, details);
+	}
+}
+
+/**
+ * Provider errors (API, model not found, etc.)
+ */
+export class ProviderError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'PROVIDER_ERROR', 500, details);
+	}
+}
+
+/**
+ * Database errors
+ */
+export class DatabaseError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'DATABASE_ERROR', 500, details);
+	}
+}
+
+/**
+ * Validation errors (bad input, schema mismatch, etc.)
+ */
+export class ValidationError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'VALIDATION_ERROR', 400, details);
+	}
+}
+
+/**
+ * Not found errors (session, agent, tool, etc.)
+ */
+export class NotFoundError extends OttoError {
+	constructor(message: string, details?: Record<string, unknown>) {
+		super(message, 'NOT_FOUND', 404, details);
+	}
+}
+
+/**
+ * Service errors from ask-service, session-manager, etc.
+ */
+export class ServiceError extends OttoError {
+	constructor(
+		message: string,
+		code = 'SERVICE_ERROR',
+		status = 500,
+		details?: Record<string, unknown>,
+	) {
+		super(message, code, status, details);
+	}
+}

package/src/core/src/index.ts

@@ -0,0 +1,108 @@
+// =======================
+// Core AI Functions (from AI SDK)
+// =======================
+export {
+	generateText,
+	streamText,
+	generateObject,
+	streamObject,
+	tool,
+} from 'ai';
+export type { ModelMessage, Tool } from 'ai';
+
+// =======================
+// Provider & Model Resolution
+// =======================
+export { resolveModel } from './providers/resolver';
+export type { ProviderName, ModelConfig } from './providers/resolver';
+
+// Re-export provider catalog and utilities for easy access
+export {
+	catalog,
+	providerIds,
+	isProviderId,
+	isProviderAuthorized,
+	validateProviderModel,
+} from '../../providers/src/index.ts';
+export type { ProviderId, ModelInfo } from '../../types/src/index.ts';
+
+// =======================
+// Tools
+// =======================
+export { discoverProjectTools } from './tools/loader';
+export type { DiscoveredTool } from './tools/loader';
+export { setTerminalManager, getTerminalManager } from './tools/loader';
+
+// Tool error handling utilities
+export {
+	isToolError,
+	extractToolError,
+	createToolError,
+} from './tools/error';
+export type {
+	ToolErrorType,
+	ToolErrorResponse,
+	ToolSuccessResponse,
+	ToolResponse,
+} from './tools/error';
+
+// Re-export builtin tools for direct access
+export { buildFsTools } from './tools/builtin/fs/index';
+export { buildGitTools } from './tools/builtin/git';
+export { buildTerminalTool } from './tools/builtin/terminal';
+
+// =======================
+// Terminals
+// =======================
+export { TerminalManager } from './terminals/index';
+export type {
+	Terminal,
+	TerminalOptions,
+	TerminalStatus,
+	TerminalCreator,
+	CreateTerminalOptions,
+} from './terminals/index';
+
+// =======================
+// Streaming & Artifacts
+// =======================
+export {
+	createFileDiffArtifact,
+	createToolResultPayload,
+} from './streaming/artifacts';
+export type {
+	Artifact,
+	FileDiffArtifact,
+	FileArtifact,
+} from './streaming/artifacts';
+
+// =======================
+// Types
+// =======================
+export type { ExecutionContext, ToolResult } from './types/index';
+
+// =======================
+// Schema Validation
+// =======================
+export { z } from 'zod';
+
+// =======================
+// Error Handling
+// =======================
+export {
+	OttoError,
+	AuthError,
+	ConfigError,
+	ToolError,
+	ProviderError,
+	DatabaseError,
+	ValidationError,
+	NotFoundError,
+	ServiceError,
+} from './errors';
+
+// =======================
+// Logging & Debug
+// =======================
+export { logger, debug, info, warn, error, time } from './utils/logger.ts';
+export { isDebugEnabled, isTraceEnabled } from './utils/debug.ts';