experimental-ash 0.2.0-alpha.22 → 0.2.0-alpha.23

package/dist/src/context/key.d.ts

@@ -47,7 +47,7 @@ export interface ContextKeyOptions<T> {
  *
  * @example Declare a durable context key and use it from a tool
  * ```ts
- * import { ContextKey, getContext, setContext } from "experimental-ash";
+ * import { ContextKey, getContext, setContext } from "experimental-ash/context";
  * import { defineTool } from "experimental-ash/tools";
  * import { z } from "zod";
  *

package/dist/src/context/key.js

@@ -18,7 +18,7 @@ const keyRegistry = new Map();
  *
  * @example Declare a durable context key and use it from a tool
  * ```ts
- * import { ContextKey, getContext, setContext } from "experimental-ash";
+ * import { ContextKey, getContext, setContext } from "experimental-ash/context";
  * import { defineTool } from "experimental-ash/tools";
  * import { z } from "zod";
  *

package/dist/src/internal/application/package.js

@@ -6,7 +6,7 @@ import { ASH_PACKAGE_NAME } from "../../package-name.js";
 let cachedPackageInfo;
 // The package build stamps the published version into `dist` so bundled
 // deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.2.0-alpha.22";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.2.0-alpha.23";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 function resolveFallbackPackageVersion() {
     return BUNDLED_FALLBACK_PACKAGE_VERSION === BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER

package/dist/src/public/context/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Runtime context helpers for authored code.
+ *
+ * These APIs work only inside active authored runtime execution such as
+ * tools and other Ash-invoked callbacks. They read from a single
+ * `AshContext` container bound via `AsyncLocalStorage`.
+ *
+ * @example
+ * ```ts
+ * import { ContextKey, getContext, setContext } from "experimental-ash/context";
+ * ```
+ */
+export { ensureContext, getContext, getSession, hasContext, requireContext, type Session, type SessionAuth, type SessionAuthContext, type SessionParent, type SessionTurn, setContext, } from "../../context/accessors.js";
+export type { AshContext } from "../../context/container.js";
+export { type ContextAccessor, ContextKey, type ContextKeyOptions, } from "../../context/key.js";
+export type { ContextProvider, ContextReader } from "../../context/provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/public/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EACL,KAAK,eAAe,EACpB,UAAU,EACV,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/public/context/index.js

@@ -0,0 +1,15 @@
+/**
+ * Runtime context helpers for authored code.
+ *
+ * These APIs work only inside active authored runtime execution such as
+ * tools and other Ash-invoked callbacks. They read from a single
+ * `AshContext` container bound via `AsyncLocalStorage`.
+ *
+ * @example
+ * ```ts
+ * import { ContextKey, getContext, setContext } from "experimental-ash/context";
+ * ```
+ */
+export { ensureContext, getContext, getSession, hasContext, requireContext, setContext, } from "../../context/accessors.js";
+export { ContextKey, } from "../../context/key.js";
+//# sourceMappingURL=index.js.map

package/dist/src/public/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EAMd,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAEL,UAAU,GAEX,MAAM,sBAAsB,CAAC"}

package/dist/src/public/index.d.ts

@@ -1,13 +1,8 @@
 export { HttpChannel } from "../channel/http-channel.js";
 export { ScheduleChannel, ScheduleDispatcher, type ScheduleTriggerInput, } from "../channel/schedule.js";
 export { SlackChannel } from "../channel/slack-channel.js";
-export { Channel, type ChannelClass, type ContextAccessor, type DeliverInput, type EventEmitFn, type RunHandle, type RunInput, type RunResult, type Runtime, } from "../channel/types.js";
-export { ensureContext, getContext, getSandbox, getSession, getSkill, hasContext, requireContext, type Session, type SessionAuth, type SessionAuthContext, type SessionParent, type SessionTurn, setContext, } from "../context/accessors.js";
-export type { AshContext } from "../context/container.js";
-export { ContextKey, type ContextKeyOptions } from "../context/key.js";
-export type { ContextProvider, ContextReader } from "../context/provider.js";
+export { Channel, type ChannelClass, type DeliverInput, type EventEmitFn, type RunHandle, type RunInput, type RunResult, type Runtime, } from "../channel/types.js";
 export { createContinuousLoopRuntime } from "../execution/continuous-runtime.js";
-export type { SkillHandle, SkillResource } from "../execution/skills/types.js";
 export { createWorkflowRuntime } from "../execution/workflow-runtime.js";
 export type { HarnessToolDefinition, ToolExecutionResult } from "../harness/execute-tool.js";
 export { createToolLoopHarness } from "../harness/tool-loop.js";
@@ -18,7 +13,6 @@ export { inputOptionSchema, inputRequestSchema, inputResponseSchema, isInputRequ
 export { type AgentCompactionDefinition, type AgentDefinition, type AgentModelDefinition, type AgentModelOptionsDefinition, defineAgent, } from "./definitions/agent.js";
 export { type Agent, type ChannelMethod, type DisabledRouteSentinel, defineRoute, disableRoute, isDisabledRouteSentinel, isRouteDefinition, type Route, type RouteContext, } from "./definitions/channel.js";
 export { defineSchedule, type ScheduleDefinition } from "./definitions/schedule.js";
-export { defineSkill, type SkillDefinition } from "./definitions/skill.js";
 export type { ModuleDefinitionExport } from "./definitions/source.js";
 export { defineSubagent, type SubagentDefinition, } from "./definitions/subagent.js";
 export { defineSystem, type SystemDefinition } from "./definitions/system.js";

package/dist/src/public/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,OAAO,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,UAAU,GACX,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAU,EACV,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,KAAK,EACV,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,KAAK,uBAAuB,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,OAAO,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAU,EACV,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,KAAK,EACV,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,KAAK,uBAAuB,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/src/public/index.js

@@ -2,8 +2,6 @@ export { HttpChannel } from "../channel/http-channel.js";
 export { ScheduleChannel, ScheduleDispatcher, } from "../channel/schedule.js";
 export { SlackChannel } from "../channel/slack-channel.js";
 export { Channel, } from "../channel/types.js";
-export { ensureContext, getContext, getSandbox, getSession, getSkill, hasContext, requireContext, setContext, } from "../context/accessors.js";
-export { ContextKey } from "../context/key.js";
 export { createContinuousLoopRuntime } from "../execution/continuous-runtime.js";
 export { createWorkflowRuntime } from "../execution/workflow-runtime.js";
 export { createToolLoopHarness } from "../harness/tool-loop.js";
@@ -11,7 +9,6 @@ export { inputOptionSchema, inputRequestSchema, inputResponseSchema, isInputRequ
 export { defineAgent, } from "./definitions/agent.js";
 export { defineRoute, disableRoute, isDisabledRouteSentinel, isRouteDefinition, } from "./definitions/channel.js";
 export { defineSchedule } from "./definitions/schedule.js";
-export { defineSkill } from "./definitions/skill.js";
 export { defineSubagent, } from "./definitions/subagent.js";
 export { defineSystem } from "./definitions/system.js";
 export { lowerScheduleMarkdown, lowerSkillMarkdown, lowerSystemMarkdown, parseMarkdownDocument, } from "./helpers/markdown.js";

package/dist/src/public/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,eAAe,EACf,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,OAAO,GASR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EAMd,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAsBhE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAKL,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAA2B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,WAAW,EAAwB,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EACL,cAAc,GAEf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAEL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,eAAe,EACf,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,OAAO,GAQR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAsBhE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAKL,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAA2B,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EACL,cAAc,GAEf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAEL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/src/public/sandboxes/index.d.ts

@@ -26,6 +26,7 @@
  * });
  * ```
  */
+export { getSandbox } from "../../context/accessors.js";
 export { type AshRuntimeSandboxMap, defineSandbox, type SandboxCommandResult, type SandboxDefinition, type SandboxLifecycleContext, type SandboxName, type SandboxReadFileOptions, type SandboxSession, } from "../definitions/sandbox.js";
 export type { SandboxBackend, SandboxBackendCreateInput, SandboxBackendHandle, SandboxBackendPrewarmInput, SandboxBackendRuntimeContext, SandboxBackendSessionState, SandboxSeedFile, SandboxSeedFilesProvider, } from "../definitions/sandbox-backend.js";
 export { defaultBackend } from "./backends/default.js";

package/dist/src/public/sandboxes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/sandboxes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACL,KAAK,oBAAoB,EACzB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/sandboxes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EACL,KAAK,oBAAoB,EACzB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/public/sandboxes/index.js

@@ -26,6 +26,7 @@
  * });
  * ```
  */
+export { getSandbox } from "../../context/accessors.js";
 export { defineSandbox, } from "../definitions/sandbox.js";
 export { defaultBackend } from "./backends/default.js";
 export { localBackend } from "./backends/local.js";

package/dist/src/public/sandboxes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/sandboxes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAEL,aAAa,GAOd,MAAM,2BAA2B,CAAC;AAWnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/sandboxes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAEL,aAAa,GAOd,MAAM,2BAA2B,CAAC;AAWnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/public/skills/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Skill authoring helpers and runtime accessors.
+ *
+ * Use {@link defineSkill} to author a skill in TypeScript with the same
+ * shape that discovery produces from markdown. Use {@link getSkill} at
+ * runtime inside authored code to read skill metadata and packaged files.
+ *
+ * @example
+ * ```ts
+ * import { defineSkill } from "experimental-ash/skills";
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { getSkill } from "experimental-ash/skills";
+ *
+ * const research = getSkill("research");
+ * const notes = await research.reference("checklist.md").text();
+ * ```
+ */
+export { getSkill } from "../../context/accessors.js";
+export type { SkillHandle, SkillResource } from "../../execution/skills/types.js";
+export { defineSkill, type SkillDefinition } from "../definitions/skill.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/public/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/public/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/public/skills/index.js

@@ -0,0 +1,23 @@
+/**
+ * Skill authoring helpers and runtime accessors.
+ *
+ * Use {@link defineSkill} to author a skill in TypeScript with the same
+ * shape that discovery produces from markdown. Use {@link getSkill} at
+ * runtime inside authored code to read skill metadata and packaged files.
+ *
+ * @example
+ * ```ts
+ * import { defineSkill } from "experimental-ash/skills";
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { getSkill } from "experimental-ash/skills";
+ *
+ * const research = getSkill("research");
+ * const notes = await research.reference("checklist.md").text();
+ * ```
+ */
+export { getSkill } from "../../context/accessors.js";
+export { defineSkill } from "../definitions/skill.js";
+//# sourceMappingURL=index.js.map

package/dist/src/public/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/public/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAwB,MAAM,yBAAyB,CAAC"}

package/docs/public/sandboxes.md

@@ -160,7 +160,7 @@ You can also bind a live sandbox directly from any authored runtime function (to
 callback) via `getSandbox`:
 
 ```ts
-import { getSandbox } from "experimental-ash";
+import { getSandbox } from "experimental-ash/sandboxes";
 import { defineTool } from "experimental-ash/tools";
 import { z } from "zod";
 

package/docs/public/session-context.md

@@ -22,7 +22,7 @@ Use `getSession()` when you need durable runtime metadata about the current exec
 `agent/tools/who_called_me.ts`
 
 ```ts
-import { getSession } from "experimental-ash";
+import { getSession } from "experimental-ash/context";
 import { defineTool } from "experimental-ash/tools";
 
 export default defineTool({
@@ -112,7 +112,7 @@ read it.
 `agent/channels/keys.ts`
 
 ```ts
-import { ContextKey } from "experimental-ash";
+import { ContextKey } from "experimental-ash/context";
 
 export const TenantKey = new ContextKey<string>("myapp.tenant");
 ```
@@ -164,7 +164,7 @@ Auth lives on `RunInput.auth` and `DeliverInput.auth`, not on the channel object
 ### Reading context from a tool
 
 ```ts
-import { requireContext } from "experimental-ash";
+import { requireContext } from "experimental-ash/context";
 import { defineTool } from "experimental-ash/tools";
 import { TenantKey } from "../channels/keys.js";
 
@@ -200,7 +200,7 @@ Providers run after `onDeliver()` and rebuild virtual values for the current ste
 import {
   ContextKey,
   type ContextProvider,
-} from "experimental-ash";
+} from "experimental-ash/context";
 import {
   slackRoute,
   SlackChannel,

package/docs/public/skills.md

@@ -78,7 +78,7 @@ Packaged skills are useful when you want files like:
 Inside authored runtime code, you can read those packaged files through `getSkill(identifier)`.
 
 ```ts
-import { getSkill } from "experimental-ash";
+import { getSkill } from "experimental-ash/skills";
 import { defineTool } from "experimental-ash/tools";
 
 export default defineTool({
@@ -138,7 +138,7 @@ Do not use a skill for:
 If markdown is not enough, you can author a skill in TypeScript with `defineSkill(...)`.
 
 ```ts
-import { defineSkill } from "experimental-ash";
+import { defineSkill } from "experimental-ash/skills";
 
 export default defineSkill({
   name: "research",

package/docs/public/tools.md

@@ -10,7 +10,7 @@ back.
 `agent/tools/get_weather.ts`
 
 ```ts
-import { getSession } from "experimental-ash";
+import { getSession } from "experimental-ash/context";
 import { defineTool } from "experimental-ash/tools";
 import { z } from "zod";
 
@@ -36,8 +36,8 @@ exposed to the model as `get_weather`; a file at `agent/tools/get-weather.ts` is
 `get-weather`. You can override that by setting `name` in the tool definition.
 
 `defineTool`, `disableTool`, `defineBashTool`, `defineReadFileTool`, and `defineWriteFileTool` live on the `experimental-ash/tools` subpath.
-Runtime helpers like `getSession`, `getSandbox`, `getSkill`, `getContext`, `requireContext`, `hasContext`, `setContext`, and `ensureContext` stay on the
-main `experimental-ash` barrel.
+Runtime context helpers (`getSession`, `getContext`, `requireContext`, `hasContext`, `setContext`, `ensureContext`) live on `experimental-ash/context`.
+`getSandbox` lives on `experimental-ash/sandboxes` and `getSkill` lives on `experimental-ash/skills`.
 
 ## What A Tool Definition Needs
 
@@ -239,7 +239,7 @@ import {
   ensureContext,
   requireContext,
   setContext,
-} from "experimental-ash";
+} from "experimental-ash/context";
 import { defineTool } from "experimental-ash/tools";
 import { z } from "zod";
 

package/docs/public/typescript-api.md

@@ -5,6 +5,8 @@ This page is the quick reference for Ash's public TypeScript surface.
 Source of truth:
 
 - main barrel: [`../../packages/ash/src/public/index.ts`](../../packages/ash/src/public/index.ts)
+- context subpath: [`../../packages/ash/src/public/context/index.ts`](../../packages/ash/src/public/context/index.ts)
+- skills subpath: [`../../packages/ash/src/public/skills/index.ts`](../../packages/ash/src/public/skills/index.ts)
 - tools subpath: [`../../packages/ash/src/public/tools/index.ts`](../../packages/ash/src/public/tools/index.ts)
 - sandboxes subpath: [`../../packages/ash/src/public/sandboxes/index.ts`](../../packages/ash/src/public/sandboxes/index.ts)
 - channel subpaths: [`../../packages/ash/src/public/channels/index.ts`](../../packages/ash/src/public/channels/index.ts)
@@ -12,24 +14,25 @@ Source of truth:
 
 ## Definition Helpers
 
-Use these to author the filesystem-backed surface. Tool authoring helpers live on
-`experimental-ash/tools`; sandbox helpers live on `experimental-ash/sandboxes`; everything else is
-on the main `experimental-ash` barrel.
+Use these to author the filesystem-backed surface. Each concern has its own subpath:
+`experimental-ash/tools` for tools, `experimental-ash/sandboxes` for sandboxes,
+`experimental-ash/skills` for skills, `experimental-ash/context` for context helpers,
+and the main `experimental-ash` barrel for agent config, routes, schedules, and systems.
 
 - `defineAgent(...)` - additive runtime config for `agent.ts`
 - `defineRoute(...)` - messaging-platform or HTTP route entrypoints in `channels/`
-- `defineSandbox(...)` - isolated bash-style environments in `sandboxes/`
+- `defineSandbox(...)` - isolated bash-style environments in `sandboxes/` (`experimental-ash/sandboxes`)
 - `defineSchedule(...)` - recurring jobs in `schedules/`
-- `defineSkill(...)` - module-authored skills
+- `defineSkill(...)` - module-authored skills (`experimental-ash/skills`)
 - `defineSubagent(...)` - local subagent entrypoint in `subagents/<id>/subagent.ts`
 - `defineSystem(...)` - module-authored system prompt
-- `defineTool(...)` - typed executable integration in `tools/<name>.ts`
-- `defineBashTool(...)` - model-visible shell tool targeting a named sandbox
-- `defineReadFileTool(...)` - model-visible file reader targeting a named sandbox
-- `defineWriteFileTool(...)` - model-visible file writer targeting a named sandbox
-- `disableTool()` - disable the framework default whose name matches `tools/<name>.ts`
+- `defineTool(...)` - typed executable integration in `tools/<name>.ts` (`experimental-ash/tools`)
+- `defineBashTool(...)` - model-visible shell tool targeting a named sandbox (`experimental-ash/tools`)
+- `defineReadFileTool(...)` - model-visible file reader targeting a named sandbox (`experimental-ash/tools`)
+- `defineWriteFileTool(...)` - model-visible file writer targeting a named sandbox (`experimental-ash/tools`)
+- `disableTool()` - disable the framework default whose name matches `tools/<name>.ts` (`experimental-ash/tools`)
 - `disableRoute()` - disable a framework-owned route that matches the file path
-- `defineEvalSuite(...)` - repeatable eval suite under `evals/*.eval.ts`
+- `defineEvalSuite(...)` - repeatable eval suite under `evals/*.eval.ts` (`experimental-ash/evals`)
 
 Framework defaults reachable for spread/wrap composition:
 
@@ -40,18 +43,19 @@ Most apps use `defineAgent`, `defineTool`, and `defineSandbox` the most.
 
 ## Runtime Helpers
 
-- `getSession()` - current session, turn, auth, and optional parent lineage
-- `getSandbox(name)` - live named sandbox session
-- `getSkill(identifier)` - handle for a named skill visible to the current agent
-- `getContext(key)` / `requireContext(key)` / `hasContext(key)` / `setContext(key)` / `ensureContext(key, factory)` - unified context helpers
+Each runtime accessor lives on the subpath that owns its concern:
 
-Related exported types:
+- `getSession()` - current session, turn, auth, and optional parent lineage (`experimental-ash/context`)
+- `getSandbox(name)` - live named sandbox session (`experimental-ash/sandboxes`)
+- `getSkill(identifier)` - handle for a named skill visible to the current agent (`experimental-ash/skills`)
+- `getContext(key)` / `requireContext(key)` / `hasContext(key)` / `setContext(key)` / `ensureContext(key, factory)` - unified context helpers (`experimental-ash/context`)
 
-- `Session`, `SessionAuth`, `SessionAuthContext`, `SessionParent`, `SessionTurn`
-- `SkillHandle`, `SkillResource`
-- `RunMode`
-- `ContextKey`, `ContextKeyOptions`, `ContextProvider`, `ContextReader`, `AshContext`
-- eval types from `experimental-ash/evals`
+Related exported types by subpath:
+
+- `experimental-ash/context`: `Session`, `SessionAuth`, `SessionAuthContext`, `SessionParent`, `SessionTurn`, `ContextKey`, `ContextKeyOptions`, `ContextProvider`, `ContextReader`, `ContextAccessor`, `AshContext`
+- `experimental-ash/skills`: `SkillHandle`, `SkillResource`, `SkillDefinition`
+- `experimental-ash`: `RunMode`
+- `experimental-ash/evals`: eval types
 
 Ash also exports lower-level runtime primitives such as `createToolLoopHarness(...)`,
 `createContinuousLoopRuntime(...)`, and `createWorkflowRuntime(...)`.
@@ -92,18 +96,24 @@ import { vercelOidc } from "experimental-ash/channels/auth";
 ### Typed Tool
 
 ```ts
-import { getSession } from "experimental-ash";
+import { getSession } from "experimental-ash/context";
 import { defineTool } from "experimental-ash/tools";
 ```
 
 ### Sandbox Access
 
 ```ts
-import { getSandbox } from "experimental-ash";
+import { getSandbox } from "experimental-ash/sandboxes";
 import { defineTool } from "experimental-ash/tools";
 import { defineBashTool } from "experimental-ash/tools";
 ```
 
+### Skill Access
+
+```ts
+import { defineSkill, getSkill } from "experimental-ash/skills";
+```
+
 ### Wrapping Or Disabling A Framework Default
 
 ```ts
@@ -134,11 +144,10 @@ import { Braintrust } from "experimental-ash/evals/reporters";
 - `defineRoute` and route/channel factories -> [`channels/README.md`](./channels/README.md)
 - `defineTool`, `disableTool`, `defineBashTool`, `defineReadFileTool`, `defineWriteFileTool`, and `experimental-ash/tools/defaults` -> [`tools.md`](./tools.md)
 - `defineSandbox` and `getSandbox` -> [`sandboxes.md`](./sandboxes.md)
+- `defineSkill` and `getSkill` -> [`skills.md`](./skills.md)
 - `getSession` -> [`session-context.md`](./session-context.md)
-- `getSkill` -> [`session-context.md`](./session-context.md)
 - `defineSubagent` -> [`subagents.md`](./subagents.md)
 - `defineSchedule` -> [`schedules.md`](./schedules.md)
-- `defineSkill` -> [`skills.md`](./skills.md)
 - `defineEvalSuite`, loaders, reporters, and scorers -> [`evals.md`](./evals.md)
 
 ## Practical Advice

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.2.0-alpha.22",
+  "version": "0.2.0-alpha.23",
   "type": "module",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
@@ -82,6 +82,16 @@
       "import": "./dist/src/evals/scores/index.js",
       "default": "./dist/src/evals/scores/index.js"
     },
+    "./skills": {
+      "types": "./dist/src/public/skills/index.d.ts",
+      "import": "./dist/src/public/skills/index.js",
+      "default": "./dist/src/public/skills/index.js"
+    },
+    "./context": {
+      "types": "./dist/src/public/context/index.d.ts",
+      "import": "./dist/src/public/context/index.js",
+      "default": "./dist/src/public/context/index.js"
+    },
     "./channels": {
       "types": "./dist/src/public/channels/index.d.ts",
       "import": "./dist/src/public/channels/index.js",