@hasna/skills 0.10.83 → 0.10.89

package/bin/migrate.js

@@ -25,7 +25,7 @@ import { join as join5 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.83",
+  version: "0.10.89",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/server.js

@@ -24140,7 +24140,7 @@ restoreLaunchCwd();
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.83",
+  version: "0.10.89",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/worker.js

@@ -24143,7 +24143,7 @@ import { randomUUID as randomUUID6 } from "crypto";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.83",
+  version: "0.10.89",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/cli/commands/agent-integration.d.ts

@@ -1,2 +1,57 @@
 import type { Command } from "commander";
+import { type IntegrationAgent } from "../../lib/agent-integration.js";
+/**
+ * Characters one managed hook's additionalContext carries at most (owner
+ * request 2026-10-30: one prompt received 10-60 KB of skill bodies). The cap
+ * covers the whole injected text: skill bodies get the cap less a fixed
+ * reserve for the loading policy, notices and `skills load` offers, and the
+ * assembled text is clamped to the cap. A body that does not fit is offered as
+ * its `skills load` command instead of being injected. Operators may lower it
+ * with SKILLS_HOOK_CONTEXT_MAX_CHARS in the agent's environment, never raise it:
+ * a larger value keeps the default. The native hook command line that
+ * `skills hook install` writes is unchanged.
+ */
+export declare const MANAGED_HOOK_CONTEXT_MAX_CHARS = 12000;
+/** Skill bodies one managed hook injects at most; SKILLS_HOOK_CONTEXT_MAX_SKILLS can only lower it. */
+export declare const MANAGED_HOOK_CONTEXT_MAX_SKILLS = 2;
+/** Part of the cap kept for the policy, notices and up to ten load offers. */
+export declare const MANAGED_HOOK_CONTEXT_RESERVE_CHARS = 2500;
+/**
+ * A managed hook injects an unnamed prompt match only for a phrase of at least
+ * this many words. A one-word trigger says little about a turn's subject, more
+ * so in long text ("effect", "rollback", "handoff"), and several of them don't
+ * add up to a phrase, so such a match is offered as a load command instead
+ * (FAO-00144). SKILLS_HOOK_PROMPT_MIN_PHRASE_WORDS can only raise it.
+ */
+export declare const MANAGED_HOOK_PROMPT_MIN_PHRASE_WORDS = 2;
+/** A subagent's start carries no prompt to match against, so its parent's skills are offered, not injected. */
+export declare const MANAGED_HOOK_INHERITED_BODIES = 0;
+/** The effective hook limits: the defaults above, or a valid lower environment override. */
+export declare function managedHookContextLimits(): {
+    maxChars: number;
+    maxSkills: number;
+    bodyChars: number;
+};
+/** The effective phrase length: the default above, or a valid higher environment override. */
+export declare function managedHookPromptMinPhraseWords(): number;
+/**
+ * The selection flags one agent's managed hook passes to its context child.
+ * Sumi's plugin and Cursor's prompt hook both discard the output of a prompt
+ * call and only deliver what a later call restores, so a pointer could never
+ * reach their models: it would turn a delivered body into nothing. They keep the
+ * plain selection until they can carry pointers.
+ */
+export declare function managedHookSelectionArgs(agent: IntegrationAgent): string[];
+/** Clamp assembled hook context to the cap at a line boundary, with a fixed note. */
+export declare function capManagedHookContext(context: string, maxChars?: number): string;
+/**
+ * Prepend a pending session pin migration notice to context the agent will
+ * read, then mark it delivered. Cursor shows hook context only at session
+ * start, and Sumi discards its prompt-admission output (its context call sends
+ * an empty prompt), so those calls leave the notice pending. OpenCode uses
+ * an explicit delivery phase, including for empty attachment-only admissions.
+ */
+export declare function withSessionPinMigrationNotice(agent: IntegrationAgent, event: string, input: unknown, result: {
+    context: string;
+}): void;
 export declare function registerAgentIntegration(parent: Command): void;

package/dist/cli/commands/context.d.ts

@@ -5,8 +5,12 @@ export declare function selectedProfileId(explicit?: string): string;
 export interface ContextCommandOptions {
     selectionProfile?: string;
     cached?: boolean;
+    cacheFirst?: boolean;
+    pointerCacheFirst?: boolean;
     autoReconcileSafe?: boolean;
     autoMigrateSessionPin?: boolean;
+    backgroundRenewal?: boolean;
+    renewalBudgetMs?: string;
     json?: boolean;
     stdin?: boolean;
     session?: string;
@@ -14,8 +18,12 @@ export interface ContextCommandOptions {
     maxChars?: string;
     maxSkills?: string;
     file?: string;
+    minPromptPhraseWords?: string;
+    inheritedBodies?: string;
 }
 export declare function contextResolverOptions(options: ContextCommandOptions): SelectionResolverOptions;
 export declare function registerContextCommands(parent: Command): void;
+/** One fixed line naming only the code of a failed renewal ahead of expiry. */
+export declare function renewAheadFailedNotice(code: string): string;
 export declare function reportContextError(error: unknown, json?: boolean): void;
 export declare function parseSkillContextInput(raw: string): SkillContextInput;

package/dist/cli/commands/runtime-launcher.d.ts

@@ -1,21 +1,16 @@
-export declare const PINNED_LAUNCHER_SCHEMA = "hasna-skills-pinned-launcher-v2";
+export declare const PINNED_LAUNCHER_SCHEMA = "hasna-skills-pinned-launcher-v3";
 /** The variable the launcher uses to hand the caller's directory to the CLI. */
 export declare const LAUNCH_CWD_VARIABLE = "HASNA_SKILLS_LAUNCH_CWD";
 /** Bun runtime flags that remove every working-directory configuration source. */
 export declare const PINNED_LAUNCHER_BUN_FLAGS: readonly ["--config=/dev/null", "--no-env-file", "--no-macros", "--no-install"];
-/**
- * Environment names passed through `env -i`, by exact name. Everything else,
- * including `BUN_*`, `NODE_OPTIONS`, `DYLD_*`, `LD_*` and proxy settings, is
- * dropped. The handling is total on purpose: a name is either listed here,
- * matches a prefix below, and passes the server-owned profile policy.
- */
-export declare const PINNED_LAUNCHER_ENV_NAMES: readonly ["HOME", "PATH", "TMPDIR", "TERM", "TERM_PROGRAM", "TERM_PROGRAM_VERSION", "COLORTERM", "LANG", "USER", "LOGNAME", "SHELL", "TZ", "NO_COLOR", "FORCE_COLOR", "CI", "COLUMNS", "LINES", "EDITOR", "VISUAL", "PAGER", "SSH_AUTH_SOCK", "TERMINAL_CWD", "CODEX_HOME", "HERMES_HOME", "HERMES_ENABLE_PROJECT_PLUGINS", "HOST", "PORT", "NODE_ENV", "AGENT_ID", "ECS_CONTAINER_METADATA_URI_V4"];
+/** V3 also preserves Claude's explicit native configuration root. */
+export declare const PINNED_LAUNCHER_ENV_NAMES: readonly ["HOME", "PATH", "TMPDIR", "TERM", "TERM_PROGRAM", "TERM_PROGRAM_VERSION", "COLORTERM", "LANG", "USER", "LOGNAME", "SHELL", "TZ", "NO_COLOR", "FORCE_COLOR", "CI", "COLUMNS", "LINES", "EDITOR", "VISUAL", "PAGER", "SSH_AUTH_SOCK", "TERMINAL_CWD", "CODEX_HOME", "HERMES_HOME", "HERMES_ENABLE_PROJECT_PLUGINS", "HOST", "PORT", "NODE_ENV", "AGENT_ID", "ECS_CONTAINER_METADATA_URI_V4", "CLAUDE_CONFIG_DIR"];
 /** Environment name prefixes passed through, for the app's own documented overrides. */
 export declare const PINNED_LAUNCHER_ENV_PREFIXES: readonly ["HASNA", "SKILLS", "SKILL", "MCP", "XDG", "LC", "AWS"];
 /** The allowlisted subset of an environment, by the same rule the launcher applies. */
 export declare function pinnedLauncherEnvironment(env: Record<string, string | undefined>, profile?: LauncherProfile): Record<string, string>;
 export type LauncherShape = "symlink" | "pinned";
-export type LauncherFormat = "v1" | "v2";
+export type LauncherFormat = "v1" | "v2" | "v3";
 export type LauncherProfile = "client" | "server";
 export interface LauncherMetadata {
     format?: LauncherFormat;