@ottocode/sdk 0.1.242 → 0.1.244

package/src/providers/src/catalog.ts

@@ -29,32 +29,6 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					output: 0,
 				},
 			},
-			{
-				id: 'codex-mini-latest',
-				ownedBy: 'openai',
-				label: 'Codex Mini',
-				modalities: {
-					input: ['text'],
-					output: ['text'],
-				},
-				toolCall: true,
-				reasoningText: true,
-				attachment: true,
-				temperature: false,
-				knowledge: '2024-04',
-				releaseDate: '2025-05-16',
-				lastUpdated: '2025-05-16',
-				openWeights: false,
-				cost: {
-					input: 1.5,
-					output: 6,
-					cacheRead: 0.375,
-				},
-				limit: {
-					context: 200000,
-					output: 100000,
-				},
-			},
 			{
 				id: 'gpt-3.5-turbo',
 				ownedBy: 'openai',
@@ -1752,7 +1726,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-05',
+				knowledge: '2025-05-31',
 				releaseDate: '2026-02-05',
 				lastUpdated: '2026-03-13',
 				openWeights: false,
@@ -1778,8 +1752,8 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				toolCall: true,
 				reasoningText: true,
 				attachment: true,
-				temperature: true,
-				knowledge: '2026-01',
+				temperature: false,
+				knowledge: '2026-01-31',
 				releaseDate: '2026-04-16',
 				lastUpdated: '2026-04-16',
 				openWeights: false,
@@ -1914,7 +1888,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-08',
+				knowledge: '2025-08-31',
 				releaseDate: '2026-02-17',
 				lastUpdated: '2026-03-13',
 				openWeights: false,
@@ -2345,7 +2319,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				cost: {
 					input: 1.25,
 					output: 10,
-					cacheRead: 0.31,
+					cacheRead: 0.125,
 				},
 				limit: {
 					context: 1048576,
@@ -3060,7 +3034,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-05-30',
+				knowledge: '2025-05-31',
 				releaseDate: '2026-02-05',
 				lastUpdated: '2026-02-05',
 				openWeights: false,
@@ -3075,6 +3049,33 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					output: 128000,
 				},
 			},
+			{
+				id: 'anthropic/claude-opus-4.7',
+				ownedBy: 'anthropic',
+				label: 'Claude Opus 4.7',
+				modalities: {
+					input: ['text', 'image', 'pdf'],
+					output: ['text'],
+				},
+				toolCall: true,
+				reasoningText: true,
+				attachment: true,
+				temperature: false,
+				knowledge: '2026-01-31',
+				releaseDate: '2026-04-16',
+				lastUpdated: '2026-04-16',
+				openWeights: false,
+				cost: {
+					input: 5,
+					output: 25,
+					cacheRead: 0.5,
+					cacheWrite: 6.25,
+				},
+				limit: {
+					context: 1000000,
+					output: 128000,
+				},
+			},
 			{
 				id: 'anthropic/claude-sonnet-4',
 				ownedBy: 'anthropic',
@@ -3141,6 +3142,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
+				knowledge: '2025-08-31',
 				releaseDate: '2026-02-17',
 				lastUpdated: '2026-02-17',
 				openWeights: false,
@@ -3687,7 +3689,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				cost: {
 					input: 1.25,
 					output: 10,
-					cacheRead: 0.31,
+					cacheRead: 0.125,
 				},
 				limit: {
 					context: 1048576,
@@ -7296,9 +7298,9 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-08-31',
+				knowledge: '2025-05-31',
 				releaseDate: '2026-02-05',
-				lastUpdated: '2026-02-05',
+				lastUpdated: '2026-03-13',
 				openWeights: false,
 				cost: {
 					input: 5,
@@ -7325,8 +7327,8 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				toolCall: true,
 				reasoningText: true,
 				attachment: true,
-				temperature: true,
-				knowledge: '2026-01',
+				temperature: false,
+				knowledge: '2026-01-31',
 				releaseDate: '2026-04-16',
 				lastUpdated: '2026-04-16',
 				openWeights: false,
@@ -7416,7 +7418,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-07-31',
+				knowledge: '2025-08-31',
 				releaseDate: '2026-02-17',
 				lastUpdated: '2026-02-17',
 				openWeights: false,
@@ -9689,7 +9691,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
-				knowledge: '2025-03-31',
+				knowledge: '2025-05-31',
 				releaseDate: '2026-02-05',
 				lastUpdated: '2026-02-05',
 				openWeights: false,
@@ -9702,6 +9704,31 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					output: 64000,
 				},
 			},
+			{
+				id: 'claude-opus-4.7',
+				ownedBy: 'anthropic',
+				label: 'Claude Opus 4.7',
+				modalities: {
+					input: ['text', 'image'],
+					output: ['text'],
+				},
+				toolCall: true,
+				reasoningText: true,
+				attachment: true,
+				temperature: false,
+				knowledge: '2026-01-31',
+				releaseDate: '2026-04-16',
+				lastUpdated: '2026-04-16',
+				openWeights: false,
+				cost: {
+					input: 0,
+					output: 0,
+				},
+				limit: {
+					context: 144000,
+					output: 64000,
+				},
+			},
 			{
 				id: 'claude-opus-41',
 				ownedBy: 'anthropic',
@@ -9789,6 +9816,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 				reasoningText: true,
 				attachment: true,
 				temperature: true,
+				knowledge: '2025-08-31',
 				releaseDate: '2026-02-17',
 				lastUpdated: '2026-02-17',
 				openWeights: false,

package/src/skills/parser.ts

@@ -60,12 +60,16 @@ function parseYamlFrontmatter(
 		const key = normalizeKey(trimmed.slice(0, colonIdx).trim());
 		const value = trimmed.slice(colonIdx + 1).trim();
 
-		if (value === '|' || value === '>') {
+		// Handle YAML block scalars with optional chomping/indentation indicators:
+		// `|`, `>`, `|-`, `>-`, `|+`, `>+`, `|2`, `>2-`, etc.
+		const blockScalarMatch = value.match(/^([|>])[-+]?\d*[-+]?$/);
+		if (blockScalarMatch) {
+			const style = blockScalarMatch[1] as '|' | '>';
 			const { content, nextIndex } = readBlockScalar(
 				lines,
 				index + 1,
 				indent,
-				value,
+				style,
 			);
 			result[key] = content;
 			index = nextIndex;
@@ -142,8 +146,10 @@ function readNestedObject(
 		const key = normalizeKey(trimmed.slice(0, colonIdx).trim());
 		const value = trimmed.slice(colonIdx + 1).trim();
 
-		if (value === '|' || value === '>') {
-			const block = readBlockScalar(lines, index + 1, indent, value);
+		const blockScalarMatch = value.match(/^([|>])[-+]?\d*[-+]?$/);
+		if (blockScalarMatch) {
+			const style = blockScalarMatch[1] as '|' | '>';
+			const block = readBlockScalar(lines, index + 1, indent, style);
 			result[key] = block.content;
 			index = block.nextIndex;
 			continue;

package/src/skills/tool.ts

@@ -120,32 +120,53 @@ async function loadSubFile(
 
 function buildSkillDescription(): string {
 	if (cachedSkillList.length === 0) {
-		return 'Load a skill by name. No skills are currently available.';
+		return 'Load a skill by name to get detailed, task-specific instructions. No skills are currently available.';
 	}
 
-	const skillsXml = cachedSkillList
+	// Dedupe by name — later scopes (cwd > repo > user) have already overwritten
+	// earlier ones in the loader, so the cached list is deduplicated. We re-dedupe
+	// defensively here in case the same name slipped through from different dirs.
+	const seen = new Set<string>();
+	const unique: DiscoveredSkill[] = [];
+	for (const s of cachedSkillList) {
+		const key = s.name.trim();
+		if (!key || seen.has(key)) continue;
+		seen.add(key);
+		unique.push(s);
+	}
+	unique.sort((a, b) => a.name.localeCompare(b.name));
+
+	const skillsXml = unique
 		.map(
 			(s) =>
-				`<skill><name>${escapeXml(s.name)}</name><description>${escapeXml(s.description)}</description></skill>`,
+				`<skill><name>${escapeXml(s.name)}</name><description>${escapeXml(summarizeDescription(s.description))}</description><location>${escapeXml(s.scope)}</location></skill>`,
 		)
 		.join('\n');
 
-	return `Load a skill by name to get detailed instructions.
+	return `Load a skill by name to get detailed, task-specific instructions.
 
-<available_skills>
-${skillsXml}
-</available_skills>
+<skills_instructions>
+When the user's request matches one of the available skills below, call this tool with the skill name to load its full instructions. Skills provide specialized capabilities and domain knowledge.
 
-Call this tool with the skill name when you need the full instructions.
-If the skill references sub-files (e.g. rules/animations.md), load them with the \`file\` parameter:
-  skill({ name: "skill-name", file: "rules/animations.md" })
+How to use skills:
+- Invoke with \`skill({ name: "<skill-name>" })\` — only the name is required.
+- The response contains the skill's full body plus \`availableFiles\` for sub-files.
+- For sub-files: \`skill({ name: "<skill-name>", file: "rules/animations.md" })\`.
 
-The response includes \`availableFiles\` listing all loadable sub-files in the skill directory.
-If \`securityNotices\` are present, review them — they flag hidden content (HTML comments, invisible characters, etc.) that may not be visible when reading the markdown normally.`;
+Rules:
+- Only invoke skills listed in <available_skills> below.
+- Do NOT invoke speculatively. Only call when the user's request clearly matches a skill's description or trigger phrases.
+- Do NOT invoke the same skill twice in one turn.
+- If a skill response includes \`securityNotices\`, review them — they flag hidden content (HTML comments, invisible characters, etc.) that may not render visibly.
+</skills_instructions>
+
+<available_skills>
+${skillsXml}
+</available_skills>`;
 }
 
 function escapeXml(str: string): string {
-	return str
+	return String(str)
 		.replace(/&/g, '&amp;')
 		.replace(/</g, '&lt;')
 		.replace(/>/g, '&gt;')
@@ -153,6 +174,63 @@ function escapeXml(str: string): string {
 		.replace(/'/g, '&apos;');
 }
 
+// Condense a SKILL.md description to "what it does + when to use it".
+//
+// Most frontmatter follows one of two shapes:
+//   A. "<what>. Use when <triggers>. Also use when … For X, see Y."
+//   B. "When the user wants X. Also use when <mega trigger list>. For Y, see Z."
+//
+// Rule: keep up to two sentences, but STOP early at cues that mark pure
+// trigger-list expansion or see-also chatter ("Also use when …", "For X, see Y",
+// "Use this …"). Sentence 1 is always kept. Sentence 2 is kept only if it's a
+// "Use when …" clause (trigger phrases the model actually needs) — not an
+// "Also use when" balloon.
+const SENTENCE_END = /[.!?]\s/g;
+const SKIP_PREFIXES = [
+	/^also use when\b/i,
+	/^for [^.]*?,?\s*see\b/i,
+	/^see\s+/i,
+	/^use this\b/i,
+	/^use proactively\b/i,
+	/^distinct from\b/i,
+	/^different from\b/i,
+	/^not for\b/i,
+];
+
+function shouldSkipSentence(sentence: string): boolean {
+	const s = sentence.trim();
+	return SKIP_PREFIXES.some((re) => re.test(s));
+}
+
+export function summarizeDescription(raw: string): string {
+	const text = String(raw ?? '')
+		.replace(/\s+/g, ' ')
+		.trim();
+	if (!text) return '';
+
+	// Split into sentences, keeping terminal punctuation.
+	const sentences: string[] = [];
+	SENTENCE_END.lastIndex = 0;
+	let lastIndex = 0;
+	let match: RegExpExecArray | null;
+	// biome-ignore lint/suspicious/noAssignInExpressions: standard regex iteration
+	while ((match = SENTENCE_END.exec(text)) !== null) {
+		sentences.push(text.slice(lastIndex, match.index + 1).trim());
+		lastIndex = match.index + match[0].length;
+	}
+	if (lastIndex < text.length) sentences.push(text.slice(lastIndex).trim());
+
+	if (sentences.length === 0) return text;
+
+	const kept: string[] = [sentences[0]]; // always keep sentence 1 (what)
+	// Keep sentence 2 only if it adds routing signal (e.g. starts with "Use when").
+	if (sentences[1] && !shouldSkipSentence(sentences[1])) {
+		kept.push(sentences[1]);
+	}
+
+	return kept.join(' ');
+}
+
 export function rebuildSkillDescription(): string {
 	return buildSkillDescription();
 }