experimental-ash 0.47.0 → 0.48.0

package/dist/src/shared/dynamic-tool-definition.d.ts

@@ -11,6 +11,14 @@ type ToolContext = SessionContext;
  */
 export type DynamicToolEventName = Extract<HandleMessageStreamEvent["type"], "session.started" | "turn.started" | "step.started">;
 export declare const ALLOWED_DYNAMIC_TOOL_EVENTS: ReadonlySet<string>;
+/**
+ * Instructions and skills are restricted to session/turn boundaries.
+ * They contribute to the system prompt, which is the most
+ * cache-sensitive position in the Anthropic wire format. Keeping them
+ * stable across steps within a turn maximizes cache hits.
+ */
+export declare const ALLOWED_DYNAMIC_INSTRUCTION_EVENTS: ReadonlySet<string>;
+export declare const ALLOWED_DYNAMIC_SKILL_EVENTS: ReadonlySet<string>;
 /**
  * Context passed to a dynamic resolver's event handler (tools and skills).
  *
@@ -118,4 +126,16 @@ export declare const INSTRUCTIONS_BRAND: unique symbol;
  * properly wrapped.
  */
 export declare function isBrandedInstructionsEntry(value: unknown): boolean;
+/**
+ * Symbol-based brand stamped by `defineSkill` on every entry. Invisible
+ * in IntelliSense but checked at runtime to detect single-entry vs
+ * map-of-entries return shapes in dynamic skill resolvers.
+ */
+export declare const SKILL_BRAND: unique symbol;
+/**
+ * Returns true if `value` was stamped by `defineSkill` (has the brand
+ * symbol). Used to detect single entry vs map of entries, and to
+ * validate that entries are properly wrapped.
+ */
+export declare function isBrandedSkillEntry(value: unknown): boolean;
 export {};

package/dist/src/shared/dynamic-tool-definition.js

@@ -1 +1 @@
-const ALLOWED_DYNAMIC_TOOL_EVENTS=new Set([`session.started`,`turn.started`,`step.started`]),DYNAMIC_SENTINEL_KIND=`ash:dynamic`;function isDynamicSentinel(e){return typeof e==`object`&&!!e&&e.kind===`ash:dynamic`}const TOOL_BRAND=Symbol.for(`ash:tool-brand`);function isBrandedToolEntry(e){return typeof e==`object`&&!!e&&e[TOOL_BRAND]===!0}const INSTRUCTIONS_BRAND=Symbol.for(`ash:instructions-brand`);function isBrandedInstructionsEntry(e){return typeof e==`object`&&!!e&&e[INSTRUCTIONS_BRAND]===!0}export{ALLOWED_DYNAMIC_TOOL_EVENTS,DYNAMIC_SENTINEL_KIND,INSTRUCTIONS_BRAND,TOOL_BRAND,isBrandedInstructionsEntry,isBrandedToolEntry,isDynamicSentinel};
+const ALLOWED_DYNAMIC_TOOL_EVENTS=new Set([`session.started`,`turn.started`,`step.started`]),ALLOWED_DYNAMIC_INSTRUCTION_EVENTS=new Set([`session.started`,`turn.started`]),ALLOWED_DYNAMIC_SKILL_EVENTS=new Set([`session.started`,`turn.started`]),DYNAMIC_SENTINEL_KIND=`ash:dynamic`;function isDynamicSentinel(e){return typeof e==`object`&&!!e&&e.kind===`ash:dynamic`}const TOOL_BRAND=Symbol.for(`ash:tool-brand`);function isBrandedToolEntry(e){return typeof e==`object`&&!!e&&e[TOOL_BRAND]===!0}const INSTRUCTIONS_BRAND=Symbol.for(`ash:instructions-brand`);function isBrandedInstructionsEntry(e){return typeof e==`object`&&!!e&&e[INSTRUCTIONS_BRAND]===!0}const SKILL_BRAND=Symbol.for(`ash:skill-brand`);function isBrandedSkillEntry(e){return typeof e==`object`&&!!e&&e[SKILL_BRAND]===!0}export{ALLOWED_DYNAMIC_INSTRUCTION_EVENTS,ALLOWED_DYNAMIC_SKILL_EVENTS,ALLOWED_DYNAMIC_TOOL_EVENTS,DYNAMIC_SENTINEL_KIND,INSTRUCTIONS_BRAND,SKILL_BRAND,TOOL_BRAND,isBrandedInstructionsEntry,isBrandedSkillEntry,isBrandedToolEntry,isDynamicSentinel};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"