experimental-ash 0.47.0 → 0.49.0

package/dist/src/runtime/hooks/registry.js

@@ -1 +1 @@
-function createEmptyHookRegistry(){return{session:[],turn:[],streamEventsByType:new Map,streamEventsWildcard:[]}}function createRuntimeHookRegistry(e){let t=[],n=[],r=new Map,i=[];for(let a of e){let e=a.lifecycle.session;e!==void 0&&t.push({slug:a.slug,handler:e});let o=a.lifecycle.turn;o!==void 0&&n.push({slug:a.slug,handler:o});for(let[e,t]of Object.entries(a.events)){let n={slug:a.slug,handler:t,eventType:e};if(e===`*`)i.push(n);else{let t=r.get(e)??[];t.push(n),r.set(e,t)}}}return{session:t,turn:n,streamEventsByType:r,streamEventsWildcard:i}}export{createEmptyHookRegistry,createRuntimeHookRegistry};
+function createEmptyHookRegistry(){return{streamEventsByType:new Map,streamEventsWildcard:[]}}function createRuntimeHookRegistry(e){let t=new Map,n=[];for(let r of e)for(let[e,i]of Object.entries(r.events)){let a={slug:r.slug,handler:i,eventType:e};if(e===`*`)n.push(a);else{let n=t.get(e)??[];n.push(a),t.set(e,n)}}return{streamEventsByType:t,streamEventsWildcard:n}}export{createEmptyHookRegistry,createRuntimeHookRegistry};

package/dist/src/runtime/resolve-hook.d.ts

@@ -5,9 +5,9 @@ import type { ResolvedHookDefinition } from "./types.js";
  * Resolves one compiled authored hook into a runtime-owned definition
  * with live handlers reattached from the authored module.
  *
- * The authored shape is `{ lifecycle?: { session?, turn? }, events?: { ... } }`.
+ * The authored shape is `{ events?: { ... } }`.
  * Each declared handler must be a function. Any other shape raises a
  * {@link ResolveAgentError} so typos surface at resolve time instead of
- * at first lifecycle call.
+ * at first dispatch call.
  */
 export declare function resolveHookDefinition(definition: CompiledHookDefinition, moduleMap: CompiledModuleMap, nodeId: string | undefined): Promise<ResolvedHookDefinition>;

package/dist/src/runtime/resolve-hook.js

@@ -1 +1 @@
-import{expectFunction,expectObjectRecord}from"../internal/authored-module.js";import{ResolveAgentError,loadResolvedModuleExport}from"./resolve-helpers.js";import{toErrorMessage}from"../shared/errors.js";async function resolveHookDefinition(a,o,s){try{let n=expectObjectRecord(await loadResolvedModuleExport({definition:a,kindLabel:`hook`,moduleMap:o,nodeId:s}),describe(a,`to return an object`)),i={},c={},l=n.lifecycle;if(l!==void 0){let n=expectObjectRecord(l,describe(a,"to expose `lifecycle` as an object"));for(let t of[`session`,`turn`]){let r=n[t];r!==void 0&&(i[t]=expectFunction(r,describe(a,`to provide a function for "lifecycle.${t}"`)))}}let u=n.events;if(u!==void 0){let n=expectObjectRecord(u,describe(a,"to expose `events` as an object"));for(let[t,r]of Object.entries(n))r!==void 0&&(c[t]=expectFunction(r,describe(a,`to provide a function for "events.${t}"`)))}return{events:c,exportName:a.exportName,lifecycle:i,logicalPath:a.logicalPath,slug:a.slug,sourceId:a.sourceId,sourceKind:`module`}}catch(e){throw e instanceof ResolveAgentError?e:new ResolveAgentError(`Failed to attach hook handlers from "${a.logicalPath}": ${toErrorMessage(e)}`,{logicalPath:a.logicalPath,sourceId:a.sourceId})}}function describe(e,t){return`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" ${t}.`}export{resolveHookDefinition};
+import{expectFunction,expectObjectRecord}from"../internal/authored-module.js";import{ResolveAgentError,loadResolvedModuleExport}from"./resolve-helpers.js";import{toErrorMessage}from"../shared/errors.js";async function resolveHookDefinition(a,o,s){try{let n=expectObjectRecord(await loadResolvedModuleExport({definition:a,kindLabel:`hook`,moduleMap:o,nodeId:s}),describe(a,`to return an object`)),i={},c=n.events;if(c!==void 0){let n=expectObjectRecord(c,describe(a,"to expose `events` as an object"));for(let[t,r]of Object.entries(n))r!==void 0&&(i[t]=expectFunction(r,describe(a,`to provide a function for "events.${t}"`)))}return{events:i,exportName:a.exportName,logicalPath:a.logicalPath,slug:a.slug,sourceId:a.sourceId,sourceKind:`module`}}catch(e){throw e instanceof ResolveAgentError?e:new ResolveAgentError(`Failed to attach hook handlers from "${a.logicalPath}": ${toErrorMessage(e)}`,{logicalPath:a.logicalPath,sourceId:a.sourceId})}}function describe(e,t){return`Expected the hook export "${e.exportName??`default`}" from "${e.logicalPath}" ${t}.`}export{resolveHookDefinition};

package/dist/src/runtime/types.d.ts

@@ -6,7 +6,7 @@ import type { DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
 import type { ChannelMethod, RouteContext } from "#public/definitions/channel.js";
 import type { RouteHandler } from "#channel/routes.js";
 import type { OutboundAuthFn } from "#public/agents/auth.js";
-import type { LifecycleHooks, StreamEventHook } from "#public/definitions/hook.js";
+import type { StreamEventHook } from "#public/definitions/hook.js";
 import type { CompactionInput, CompactionHookResult, NeedsApprovalContext, ToolModelOutput, ToolRetentionPolicy } from "#public/definitions/tool.js";
 import type { AuthorizationDefinition, HeadersDefinition, ToolFilterDefinition } from "#runtime/connections/types.js";
 import type { CompiledWorkspaceResourceRoot } from "#compiler/manifest.js";
@@ -148,8 +148,8 @@ export type ResolvedToolDefinition = Readonly<Optional<InternalToolDefinitionWit
 };
 /**
  * Runtime-owned authored hook definition resolved from a compiled module
- * map. Carries live lifecycle and stream-event handlers reattached from
- * the authored module's exported nested maps.
+ * map. Carries live stream-event handlers reattached from the authored
+ * module's exported nested maps.
  *
  * Per-handler validation runs at resolve time inside
  * {@link resolveHookDefinition}; missing handlers are simply absent from
@@ -160,12 +160,6 @@ export interface ResolvedHookDefinition extends ResolvedModuleSourceRef {
      * Path-relative slug used for diagnostics and ordering.
      */
     readonly slug: string;
-    /**
-     * Lifecycle subscribers reattached from the authored
-     * `lifecycle: { session?, turn? }` map. Keys not present on the
-     * authored map are absent here.
-     */
-    readonly lifecycle: LifecycleHooks;
     /**
      * Stream-event subscribers reattached from the authored
      * `events: { ... }` map, keyed by event type. Includes the `*`

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.49.0",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"