@agent-api/sdk 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog — @agent-api/sdk
 
+## 1.0.6
+
+### Changed
+
+- Replaced skill focus `max_manifest_bytes` with `max_manifest_chars`.
+- Local skill `SKILL.md` manifests are decoded as strict UTF-8 and truncated by characters.
+
 ## 1.0.5
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 Production JavaScript/TypeScript SDK for the Managed Agent API.
 
-**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.5)
+**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.6)
 
 ## Install
 

package/dist/local-skills.js

@@ -1,4 +1,5 @@
 import { functionCallOutputInput, pendingFunctionCalls } from "./local-functions.js";
+const DEFAULT_FOCUS_MANIFEST_CHARS = 16000;
 export async function localSkillFromDirectory(rootDir, options = {}) {
     const fs = await import("node:fs/promises");
     const path = await import("node:path");
@@ -37,7 +38,7 @@ export async function runLocalSkillHandlers(response, localSkills) {
     return outputs;
 }
 async function focusLocalSkills(args, byID) {
-    const maxManifestBytes = Number(args.max_manifest_bytes || 16 * 1024);
+    const maxManifestChars = manifestCharLimit(args);
     const items = Array.isArray(args.skills) ? args.skills : [];
     if (!Array.isArray(args.skills)) {
         return { data: [{ ok: false, error: { code: "invalid_skill_focus", message: "skills must be an array" } }] };
@@ -58,7 +59,7 @@ async function focusLocalSkills(args, byID) {
             continue;
         }
         try {
-            result.skill = await focusedLocalSkill(descriptor, maxManifestBytes);
+            result.skill = await focusedLocalSkill(descriptor, maxManifestChars);
             result.ok = true;
         }
         catch (error) {
@@ -68,9 +69,10 @@ async function focusLocalSkills(args, byID) {
     }
     return { data };
 }
-async function focusedLocalSkill(descriptor, maxManifestBytes) {
+async function focusedLocalSkill(descriptor, maxManifestChars) {
     const fs = await import("node:fs/promises");
     const path = await import("node:path");
+    const { TextDecoder } = await import("node:util");
     const root = path.resolve(descriptor.root_hint || ".");
     const stat = await fs.stat(root);
     if (!stat.isDirectory()) {
@@ -79,12 +81,13 @@ async function focusedLocalSkill(descriptor, maxManifestBytes) {
     let manifest = "";
     let manifestTruncated = false;
     try {
-        let manifestBytes = await fs.readFile(path.join(root, "SKILL.md"));
-        if (maxManifestBytes > 0 && manifestBytes.length > maxManifestBytes) {
-            manifestBytes = manifestBytes.subarray(0, maxManifestBytes);
+        const manifestBytes = await fs.readFile(path.join(root, "SKILL.md"));
+        manifest = new TextDecoder("utf-8", { fatal: true }).decode(manifestBytes);
+        const manifestChars = Array.from(manifest);
+        if (maxManifestChars > 0 && manifestChars.length > maxManifestChars) {
+            manifest = manifestChars.slice(0, maxManifestChars).join("");
             manifestTruncated = true;
         }
-        manifest = manifestBytes.toString("utf8");
     }
     catch (error) {
         if (error?.code !== "ENOENT") {
@@ -120,6 +123,11 @@ async function focusedLocalSkill(descriptor, maxManifestBytes) {
         metadata: descriptor.metadata || {},
     };
 }
+function manifestCharLimit(args) {
+    const raw = args.max_manifest_chars ?? DEFAULT_FOCUS_MANIFEST_CHARS;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : DEFAULT_FOCUS_MANIFEST_CHARS;
+}
 async function walkFiles(fs, path, root, dir) {
     const entries = await fs.readdir(dir, { withFileTypes: true });
     const out = [];

package/dist/types/skills.d.ts

@@ -102,7 +102,7 @@ export interface DiscoverSkillsParams {
 export interface FocusSkillParams {
     skills: SkillFocusItem[];
     fallback_to_main?: boolean;
-    max_manifest_bytes?: number;
+    max_manifest_chars?: number;
 }
 export interface SkillFileMutation {
     path: string;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.5";
-export declare const USER_AGENT = "@agent-api/sdk/1.0.5";
+export declare const VERSION = "1.0.6";
+export declare const USER_AGENT = "@agent-api/sdk/1.0.6";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.0.5";
+export const VERSION = "1.0.6";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {