@hasna/skills 0.2.0 → 0.2.1

package/dist/lib/portable-skills-files.d.ts

@@ -11,6 +11,15 @@ export declare function defaultProvenance(sourceCommit?: string): PortableSkillP
 export declare function normalizePortableSkillName(name: string): string;
 export declare function readPortableSkillManifest(skillPath: string, fallbackName?: string): PortableSkillManifest;
 export declare function parseSkillKind(value: string | undefined): SkillKind | undefined;
+/**
+ * The version a skill EXPLICITLY declares, or undefined when none of the sources do:
+ * skill.json first, then the SKILL.md frontmatter, then package.json.
+ *
+ * Distinct from `readPortableSkillManifest().version`, which falls back to
+ * PORTABLE_SKILL_DEFAULT_VERSION: callers that must not invent a version (publishing,
+ * version pinning) use this and refuse when it is undefined.
+ */
+export declare function readDeclaredSkillVersion(skillPath: string): string | undefined;
 export declare function createInstructionManifest(name: string, options: {
     description: string;
 }): PortableSkillManifest;

package/dist/lib/portable-skills.d.ts

@@ -1,8 +1,8 @@
 import type { SkillKind, SkillMeta } from "./registry-types.js";
 import { type SkillValidationResult } from "./skill-validation.js";
-import { normalizePortableSkillName, readPortableSkillManifest } from "./portable-skills-files.js";
+import { normalizePortableSkillName, readDeclaredSkillVersion, readPortableSkillManifest } from "./portable-skills-files.js";
 import type { BulkPortPortableSkillOptions, BulkPortResult, PortableSkillOptions, PortableSkillRunOptions, PortableSkillRunResult, PortableSkillSummary, PortableSkillWriteResult, PortPortableSkillOptions, ScaffoldPortableSkillOptions } from "./portable-skills-types.js";
-export { normalizePortableSkillName, readPortableSkillManifest, };
+export { normalizePortableSkillName, readDeclaredSkillVersion, readPortableSkillManifest, };
 export * from "./portable-skills-types.js";
 /**
  * Resolve the corpus: the directory holding one folder per installed skill.

package/dist/lib/remote-client.d.ts

@@ -120,11 +120,11 @@ export declare class RemoteSkillsClient {
      * instance serves no bundle for this skill (the metadata-only fallback path).
      */
     getBundle(slug: string, version?: string): Promise<Response | null>;
-    /** List the pins the instance holds for this principal. */
     /** Every published version of a slug, newest first (hasna/apps#1630). */
     listSkillVersions(slug: string): Promise<RemoteSkillVersion[]>;
     /** One version's manifest, or null when the slug@version was never published. */
     getSkillVersion(slug: string, version: string): Promise<RemoteSkillVersion | null>;
+    /** List the pins the instance holds for this principal. */
     listPins(): Promise<RemotePin[]>;
     /**
      * Pin a skill on the instance (upsert — pinning again refreshes it). The