@hasna/skills 0.10.65 → 0.10.67

package/dist/lib/agent-discovery.d.ts

@@ -4,7 +4,7 @@ import { type ManagedPluginRegistrationWitness } from "./plugin-discovery.js";
 import { type CodexHookDiscoveryRecovery } from "./codex-hook-discovery-recovery.js";
 import { type CodexPluginSkillControl, type CodexPluginSourceInput } from "./codex-plugin-skill-controls.js";
 import { type RetainedReviewArtifact, type ReviewedArtifact } from "./retained-review-artifacts.js";
-import { type CodexSemanticCacheWitness, type CodexSemanticCacheAppOnlyParent } from "./codex-semantic-cache-witness.js";
+import { type CodexSemanticCacheWitness, type CodexSemanticCacheAppOnlyParent, type CodexSemanticCacheReviewedHookParent } from "./codex-semantic-cache-witness.js";
 export { captureDiscoveryDirectories, type DiscoveryDirectory } from "./agent-discovery-directories.js";
 export interface DiscoverySource {
     reviewArtifact?: RetainedReviewArtifact;
@@ -26,6 +26,7 @@ export interface CodexSemanticCacheDiscovery {
     } | null;
     witness: CodexSemanticCacheWitness;
     appOnlyParents: CodexSemanticCacheAppOnlyParent[];
+    reviewedHookParents?: CodexSemanticCacheReviewedHookParent[];
     previousPolicySha256: string;
     supersededSources: DiscoverySource[];
     supersededDirectories: DiscoveryDirectory[];
@@ -93,7 +94,7 @@ export declare function projectNativeDiscoveryFields(text: string, format: "json
 export declare function captureRetiredCodexDiscovery(binding: AgentDiscoveryBinding, controls: CodexPluginSkillControl[], rules: unknown): AgentDiscoveryBinding;
 /** Only native capability locations covered by the complete typed cache census
  * qualify. Historical sources remain stored; arbitrary missing files do not. */
-export declare function codexSemanticCacheSourceRole(source: DiscoverySource, cacheRoot: string, parents: readonly string[]): boolean;
+export declare function codexSemanticCacheSourceRole(source: DiscoverySource, cacheRoot: string, parents: readonly string[], hookParents?: readonly string[]): boolean;
 export declare function codexSemanticCacheDirectoryRole(path: string, cacheRoot: string): boolean;
 export declare function assertCodexSemanticCacheHookSafety(cacheRoot: string, parents: readonly string[], configPath: string, hookRootAlias?: CodexSemanticCacheDiscovery["hookRootAlias"]): void;
 export declare function verifyAgentDiscovery(binding: AgentDiscoveryBinding, codexRecovery?: CodexHookDiscoveryRecovery, reviewedRootAliases?: readonly {

package/dist/lib/agent-integration.d.ts

@@ -215,6 +215,8 @@ export declare function planAgentSettingsWitnessUpgrade(options: {
 export interface CodexSemanticCacheUpgrade {
     agent: "codex";
     appOnlyParents: string[];
+    /** Explicit cache parents whose complete native mcp_tool hook contract was already enrolled. */
+    reviewedHookParents?: string[];
     expectedPolicySha256: string;
     expectedSettingsSha256: string;
     expectedCacheWitnessSha256?: string;

package/dist/lib/codex-semantic-cache-witness.d.ts

@@ -32,11 +32,31 @@ export interface CodexSemanticCacheAppOnlyParentWitness extends CodexSemanticCac
     appSha256: string;
     mcpSha256?: string;
 }
+/** Explicitly reviewed native MCP-hook parent. Its cache materializations are
+ * admitted only when the complete manifest and hooks declaration were already
+ * enrolled as full-byte native discovery sources. */
+export interface CodexSemanticCacheReviewedHookParent {
+    role: "reviewed-hook";
+    pluginId: string;
+    namespace: string;
+    pluginParent: string;
+    installation: "remote-receipt" | "local-marketplace";
+    remotePluginId?: string;
+    marketplaceSourcePath?: string;
+    marketplaceSha256?: string;
+}
+export interface CodexSemanticCacheReviewedHookParentWitness extends CodexSemanticCacheReviewedHookParent {
+    manifestSha256: string;
+    hooksSha256: string;
+    receiptSha256?: string;
+}
 export interface CodexSemanticCacheWitness {
     schema: typeof CODEX_SEMANTIC_CACHE_WITNESS_SCHEMA;
     cacheRoot: string;
     controls: CodexSemanticCacheControl[];
     appOnlyParents: CodexSemanticCacheAppOnlyParentWitness[];
+    /** Optional only for compatibility with already persisted v1 witnesses. */
+    hookParents?: CodexSemanticCacheReviewedHookParentWitness[];
     skills: CodexSemanticCacheSkill[];
     sha256: string;
 }
@@ -45,10 +65,13 @@ export interface CaptureCodexSemanticCacheWitnessOptions {
     controls: CodexPluginSkillControl[];
     /** Explicit package-reviewed parents; absence never infers this role. */
     appOnlyParents?: CodexSemanticCacheAppOnlyParent[];
+    /** Explicit roles only; cache presence never creates a hook role. */
+    reviewedHookParents?: CodexSemanticCacheReviewedHookParent[];
     rules: unknown;
     /** Package-owned, bounded read used by the existing semantic control review. */
     read?: (path: string) => string;
 }
+export declare function codexLocalMarketplaceMapsPlugin(text: string, marketplace: string, plugin: string): boolean;
 /** Capture the current semantic identity without changing the stored baseline.
  * Existing package-owned parsers validate documents and capability controls. */
 export declare function captureCodexSemanticCacheWitness(options: CaptureCodexSemanticCacheWitnessOptions): CodexSemanticCacheWitness;

package/dist/lib/skillinfo.d.ts

@@ -23,8 +23,18 @@ export declare function getSkillBestDoc(name: string, file?: string): string | n
  * Extract requirements from a skill's source files
  */
 export declare function getSkillRequirements(name: string): SkillRequirements | null;
-/** Shared parser for verified bundle content and explicit local authoring files. */
-export declare function getSkillRequirementsFromContent(name: string, texts: string[], dependencies?: Record<string, string>, meta?: SkillMeta): SkillRequirements;
+/**
+ * Shared parser for verified bundle content and explicit local authoring files.
+ * Public through `@hasna/skills/sdk`.
+ *
+ * The result depends only on the arguments: `texts` are the documentation
+ * contents to scan (for example SKILL.md, README.md, CLAUDE.md, .env.example),
+ * `dependencies` is the skill package's dependency map and `meta` its catalog
+ * record. It reads no registry, file, environment, install state or network,
+ * and never mutates its inputs; the returned `dependencies` is the caller's
+ * object, not a copy.
+ */
+export declare function getSkillRequirementsFromContent(name: string, texts: readonly string[], dependencies?: Record<string, string>, meta?: SkillMeta): SkillRequirements;
 export interface SkillDependencyStatus {
     name: string;
     version: string;

package/dist/runtime-prerequisites.js

@@ -49,7 +49,7 @@ var __require = import.meta.require;
 // src/runtime-prerequisites.ts
 import { isAbsolute as isAbsolute5 } from "path";
 // package.json
-var version = "0.10.65";
+var version = "0.10.67";
 var package_default = {
   name: "@hasna/skills",
   version,
@@ -2643,8 +2643,8 @@ function assertAgentPolicyCollections(policy) {
         }
     }
     if (value.codexSemanticCache !== undefined) {
-      const proof = record(value.codexSemanticCache, 8), witness = record(proof.witness, 6);
-      requireBound(agent === "codex" && value.agent === "codex" && value.method === "reviewed" && Object.keys(proof).length === 8 && proof.schema === "hasna.codex-semantic-cache-discovery.v1" && typeof proof.previousPolicySha256 === "string" && /^[a-f0-9]{64}$/.test(proof.previousPolicySha256) && Object.keys(witness).length === 6 && witness.schema === "hasna.codex-semantic-cache-witness.v1" && typeof witness.sha256 === "string" && /^[a-f0-9]{64}$/.test(witness.sha256));
+      const proof = record(value.codexSemanticCache, 9), witness = record(proof.witness, 7);
+      requireBound(agent === "codex" && value.agent === "codex" && value.method === "reviewed" && [8, 9].includes(Object.keys(proof).length) && Object.keys(proof).every((key) => ["schema", "configPath", "hookRootAlias", "witness", "appOnlyParents", "previousPolicySha256", "supersededSources", "supersededDirectories", "reviewedHookParents"].includes(key)) && proof.schema === "hasna.codex-semantic-cache-discovery.v1" && typeof proof.previousPolicySha256 === "string" && /^[a-f0-9]{64}$/.test(proof.previousPolicySha256) && [6, 7].includes(Object.keys(witness).length) && Object.keys(witness).every((key) => ["schema", "cacheRoot", "controls", "appOnlyParents", "skills", "sha256", "hookParents"].includes(key)) && witness.schema === "hasna.codex-semantic-cache-witness.v1" && typeof witness.sha256 === "string" && /^[a-f0-9]{64}$/.test(witness.sha256));
       text(proof.configPath);
       requireBound(isAbsolute3(proof.configPath) && resolve5(proof.configPath) === proof.configPath && basename3(proof.configPath) === "config.toml");
       text(witness.cacheRoot);
@@ -2663,6 +2663,20 @@ function assertAgentPolicyCollections(policy) {
           text(parent[key]);
         requireBound(isAbsolute3(parent.pluginParent) && resolve5(parent.pluginParent) === parent.pluginParent);
       }
+      if (proof.reviewedHookParents !== undefined)
+        for (const parent of array(proof.reviewedHookParents, 4096)) {
+          requireBound(object(parent) && parent.role === "reviewed-hook" && (parent.installation === "remote-receipt" && Object.keys(parent).length === 6 || parent.installation === "local-marketplace" && Object.keys(parent).length === 7));
+          requireBound(parent.installation === "remote-receipt" ? Object.keys(parent).sort().join(",") === "installation,namespace,pluginId,pluginParent,remotePluginId,role" : Object.keys(parent).sort().join(",") === "installation,marketplaceSha256,marketplaceSourcePath,namespace,pluginId,pluginParent,role");
+          for (const key of ["pluginId", "namespace", "pluginParent", "installation"])
+            text(parent[key]);
+          if (parent.installation === "remote-receipt")
+            text(parent.remotePluginId);
+          else {
+            text(parent.marketplaceSourcePath);
+            requireBound(typeof parent.marketplaceSha256 === "string" && /^[a-f0-9]{64}$/.test(parent.marketplaceSha256) && isAbsolute3(parent.marketplaceSourcePath) && resolve5(parent.marketplaceSourcePath) === parent.marketplaceSourcePath && basename3(parent.marketplaceSourcePath) === "marketplace.json");
+          }
+          requireBound(isAbsolute3(parent.pluginParent) && resolve5(parent.pluginParent) === parent.pluginParent);
+        }
       for (const row of [...array(witness.controls, 4096), ...array(witness.appOnlyParents, 4096)]) {
         requireBound(object(row));
         for (const key of ["pluginId", "namespace", "pluginParent"])
@@ -2671,6 +2685,26 @@ function assertAgentPolicyCollections(policy) {
           if (row[key] !== undefined)
             requireBound(typeof row[key] === "string" && /^[a-f0-9]{64}$/.test(row[key]));
       }
+      if (witness.hookParents !== undefined)
+        for (const row of array(witness.hookParents, 4096)) {
+          requireBound(object(row) && row.role === "reviewed-hook" && (row.installation === "remote-receipt" && Object.keys(row).length === 9 || row.installation === "local-marketplace" && Object.keys(row).length === 9));
+          requireBound(row.installation === "remote-receipt" ? Object.keys(row).sort().join(",") === "hooksSha256,installation,manifestSha256,namespace,pluginId,pluginParent,receiptSha256,remotePluginId,role" : Object.keys(row).sort().join(",") === "hooksSha256,installation,manifestSha256,marketplaceSha256,marketplaceSourcePath,namespace,pluginId,pluginParent,role");
+          for (const key of ["pluginId", "namespace", "pluginParent", "installation"])
+            text(row[key]);
+          if (row.installation === "remote-receipt")
+            text(row.remotePluginId);
+          else {
+            text(row.marketplaceSourcePath);
+            requireBound(typeof row.marketplaceSha256 === "string" && /^[a-f0-9]{64}$/.test(row.marketplaceSha256) && isAbsolute3(row.marketplaceSourcePath) && resolve5(row.marketplaceSourcePath) === row.marketplaceSourcePath && basename3(row.marketplaceSourcePath) === "marketplace.json");
+          }
+          requireBound(isAbsolute3(row.pluginParent) && resolve5(row.pluginParent) === row.pluginParent);
+          for (const key of ["manifestSha256", "hooksSha256"])
+            requireBound(typeof row[key] === "string" && /^[a-f0-9]{64}$/.test(row[key]));
+          if (row.installation === "remote-receipt")
+            requireBound(typeof row.receiptSha256 === "string" && /^[a-f0-9]{64}$/.test(row.receiptSha256));
+          else
+            requireBound(row.receiptSha256 === undefined);
+        }
       for (const skill of array(witness.skills, 4096)) {
         requireBound(object(skill));
         for (const key of ["name", "pluginId", "namespace", "pluginParent"])

package/dist/sdk/index.d.ts

@@ -44,6 +44,7 @@ export * from "../lib/remote-recurring-contract.js";
 export { RecurringInputError, RemoteRecurringError, RemoteRecurringUnavailableError, RemoteRecurringReadError, RemoteRecurringUnconfirmedError } from "../lib/remote-recurring.js";
 export type { RecurringCapability, RecurringListOptions, RemoteRecurringErrorCode } from "../lib/remote-recurring.js";
 export { canonicalJson, canonicalJsonSha256 } from "../lib/canonical-json.js";
+export { getSkillRequirementsFromContent, type SkillRequirements } from "../lib/skillinfo.js";
 export type { RemoteQuoteUnavailableCode } from "../lib/remote-client.js";
 export { RemoteCreditApprovalError, type RemoteRunApproval, type RemoteRunQuote, type RemoteCreditPack } from "../lib/remote-account.js";
 export { type RemoteInputFile, type RemoteInputFileDescriptor } from "../lib/remote-files.js";