@ottocode/sdk 0.1.173

package/src/skills/types.ts

@@ -0,0 +1,41 @@
+export type SkillScope = 'cwd' | 'parent' | 'repo' | 'user' | 'system';
+
+export interface SkillMetadata {
+	name: string;
+	description: string;
+	license?: string;
+	compatibility?: string;
+	metadata?: Record<string, string>;
+	allowedTools?: string[];
+}
+
+export interface SkillDefinition {
+	metadata: SkillMetadata;
+	content: string;
+	path: string;
+	scope: SkillScope;
+}
+
+export interface DiscoveredSkill {
+	name: string;
+	description: string;
+	path: string;
+	scope: SkillScope;
+}
+
+export interface SkillLoadResult {
+	ok: true;
+	name: string;
+	description: string;
+	content: string;
+	path: string;
+	scope: SkillScope;
+	allowedTools?: string[];
+}
+
+export interface SkillErrorResult {
+	ok: false;
+	error: string;
+}
+
+export type SkillResult = SkillLoadResult | SkillErrorResult;

package/src/skills/validator.ts

@@ -0,0 +1,110 @@
+import type { SkillMetadata } from './types.ts';
+
+const NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+const MAX_COMPATIBILITY_LENGTH = 500;
+
+export class SkillValidationError extends Error {
+	constructor(
+		message: string,
+		public path: string,
+	) {
+		super(message);
+		this.name = 'SkillValidationError';
+	}
+}
+
+export function validateMetadata(
+	meta: unknown,
+	path: string,
+): asserts meta is SkillMetadata {
+	if (!meta || typeof meta !== 'object') {
+		throw new SkillValidationError(`Invalid frontmatter in ${path}`, path);
+	}
+
+	const m = meta as Record<string, unknown>;
+
+	if (typeof m.name !== 'string' || !m.name) {
+		throw new SkillValidationError(
+			`Missing required 'name' field in ${path}`,
+			path,
+		);
+	}
+	if (m.name.length > MAX_NAME_LENGTH) {
+		throw new SkillValidationError(
+			`Skill name exceeds ${MAX_NAME_LENGTH} chars in ${path}`,
+			path,
+		);
+	}
+	if (!NAME_REGEX.test(m.name)) {
+		throw new SkillValidationError(
+			`Invalid skill name '${m.name}' - must be lowercase alphanumeric with hyphens, no start/end hyphens, no consecutive hyphens`,
+			path,
+		);
+	}
+
+	if (typeof m.description !== 'string' || !m.description) {
+		throw new SkillValidationError(
+			`Missing required 'description' field in ${path}`,
+			path,
+		);
+	}
+	if (m.description.length > MAX_DESCRIPTION_LENGTH) {
+		throw new SkillValidationError(
+			`Description exceeds ${MAX_DESCRIPTION_LENGTH} chars in ${path}`,
+			path,
+		);
+	}
+
+	if (
+		m.compatibility &&
+		typeof m.compatibility === 'string' &&
+		m.compatibility.length > MAX_COMPATIBILITY_LENGTH
+	) {
+		throw new SkillValidationError(
+			`Compatibility exceeds ${MAX_COMPATIBILITY_LENGTH} chars in ${path}`,
+			path,
+		);
+	}
+
+	if (m.metadata !== undefined) {
+		if (typeof m.metadata !== 'object' || m.metadata === null) {
+			throw new SkillValidationError(
+				`metadata must be an object in ${path}`,
+				path,
+			);
+		}
+		for (const [key, value] of Object.entries(
+			m.metadata as Record<string, unknown>,
+		)) {
+			if (typeof value !== 'string') {
+				throw new SkillValidationError(
+					`metadata.${key} must be a string in ${path}`,
+					path,
+				);
+			}
+		}
+	}
+
+	if (m['allowed-tools'] !== undefined && m.allowedTools === undefined) {
+		m.allowedTools = m['allowed-tools'];
+	}
+
+	if (m.allowedTools !== undefined) {
+		if (typeof m.allowedTools === 'string') {
+			m.allowedTools = m.allowedTools.split(/\s+/).filter(Boolean);
+		}
+		if (!Array.isArray(m.allowedTools)) {
+			throw new SkillValidationError(
+				`allowed-tools must be a string or array in ${path}`,
+				path,
+			);
+		}
+	}
+}
+
+export function validateSkillName(name: string): boolean {
+	if (!name || name.length > MAX_NAME_LENGTH) return false;
+	return NAME_REGEX.test(name);
+}

package/src/types/src/auth.ts

@@ -0,0 +1,33 @@
+import type { ProviderId } from './provider';
+
+/**
+ * API key authentication
+ */
+export type ApiAuth = { type: 'api'; key: string };
+
+/**
+ * Wallet/private-key authentication
+ */
+export type WalletAuth = { type: 'wallet'; secret: string };
+
+/**
+ * OAuth authentication tokens
+ */
+export type OAuth = {
+	type: 'oauth';
+	access: string;
+	refresh: string;
+	expires: number;
+	accountId?: string;
+	idToken?: string;
+};
+
+/**
+ * Union of all auth types
+ */
+export type AuthInfo = ApiAuth | OAuth | WalletAuth;
+
+/**
+ * Collection of auth credentials per provider
+ */
+export type AuthFile = Partial<Record<ProviderId, AuthInfo>>;

package/src/types/src/config.ts

@@ -0,0 +1,36 @@
+/**
+ * Configuration scope - where settings are stored
+ */
+export type Scope = 'global' | 'local';
+
+/**
+ * Default settings for the CLI
+ */
+export type ToolApprovalMode = 'auto' | 'dangerous' | 'all';
+
+export type DefaultConfig = {
+	agent: string;
+	provider: ProviderId;
+	model: string;
+	toolApproval?: ToolApprovalMode;
+};
+
+/**
+ * Path configuration
+ */
+export type PathConfig = {
+	dataDir: string;
+	dbPath: string;
+	projectConfigPath: string | null;
+	globalConfigPath: string | null;
+};
+
+/**
+ * Complete otto configuration object
+ */
+export type OttoConfig = {
+	projectRoot: string;
+	defaults: DefaultConfig;
+	paths: PathConfig;
+	onboardingComplete?: boolean;
+};

package/src/types/src/index.ts

@@ -0,0 +1,20 @@
+// Provider types
+export type {
+	ProviderId,
+	ProviderFamily,
+	ModelInfo,
+	ModelProviderBinding,
+	ProviderCatalogEntry,
+} from './provider';
+
+// Auth types
+export type { ApiAuth, OAuth, AuthInfo, AuthFile } from './auth';
+
+// Config types
+export type {
+	Scope,
+	DefaultConfig,
+	PathConfig,
+	OttoConfig,
+	ToolApprovalMode,
+} from './config';

package/src/types/src/provider.ts

@@ -0,0 +1,71 @@
+/**
+ * Provider identifiers for supported AI providers
+ */
+export type ProviderId =
+	| 'openai'
+	| 'anthropic'
+	| 'google'
+	| 'openrouter'
+	| 'opencode'
+	| 'copilot'
+	| 'setu'
+	| 'zai'
+	| 'zai-coding'
+	| 'moonshot';
+
+/**
+ * Provider family for prompt selection
+ */
+export type ProviderFamily =
+	| 'openai'
+	| 'anthropic'
+	| 'google'
+	| 'moonshot'
+	| 'openai-compatible';
+
+export type ModelProviderBinding = {
+	id?: string;
+	npm?: string;
+	api?: string;
+	baseURL?: string;
+	/**
+	 * The provider family for prompt selection.
+	 * Used to determine which base prompt to use for this model.
+	 */
+	family?: ProviderFamily;
+};
+
+/**
+ * Information about a specific model
+ */
+export type ModelInfo = {
+	id: string;
+	label?: string;
+	modalities?: { input?: string[]; output?: string[] };
+	toolCall?: boolean;
+	reasoningText?: boolean;
+	attachment?: boolean;
+	temperature?: boolean | number;
+	knowledge?: string;
+	releaseDate?: string;
+	lastUpdated?: string;
+	openWeights?: boolean;
+	cost?: {
+		input?: number;
+		output?: number;
+		cacheRead?: number;
+		cacheWrite?: number;
+	};
+	limit?: { context?: number; output?: number };
+	provider?: ModelProviderBinding;
+};
+
+export type ProviderCatalogEntry = {
+	id: ProviderId;
+	label?: string;
+	env?: string[];
+	npm?: string;
+	api?: string;
+	doc?: string;
+	models: ModelInfo[];
+};