@springbrand/agent-runtime 0.2.0-alpha.64 → 0.2.0-alpha.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/agent-runtime",
-  "version": "0.2.0-alpha.64",
+  "version": "0.2.0-alpha.66",
   "type": "module",
   "files": [
     "src",

package/src/index.ts

@@ -68,6 +68,7 @@ export type {
   ResolvedResources,
   RuntimeAgentContext,
   RuntimeSettings,
+  RuntimeSkillBodyTransform,
   RuntimeToolBindings,
   ToolAssemblyResult,
 } from "./runtime-definition";

package/src/pi/message/contract.ts

@@ -7,6 +7,8 @@ export interface RequestedCapability {
   readonly kind: "skill" | "tool" | "plan";
   readonly name: string;
   readonly label: string;
+  /** Stable Resource identity used only to group capabilities in presentation. */
+  readonly resourceId?: string;
 }
 
 export interface UIChatRequestBody {

package/src/pi/tool/skill.ts

@@ -13,6 +13,7 @@ import type {
   RuntimeSkillScriptPolicy,
   WorkspacePort,
 } from "../../kernel/bindings";
+import type { RuntimeSkillBodyTransform } from "../../runtime-definition";
 import { STORAGE_LEAF_MAX_CHARS } from "../../layers/context/budget/gate";
 import { serializeOutput } from "../../lib/artifacts";
 import { aiToolToPi } from "./ai-adapter";
@@ -33,6 +34,7 @@ export interface SkillPiToolOptions {
   readonly loader?: WorkerLoader;
   readonly workspace?: WorkspacePort;
   readonly tools?: readonly PiToolCandidate[];
+  readonly transformSkillBody?: RuntimeSkillBodyTransform;
 }
 
 /**
@@ -116,7 +118,11 @@ function budgetSkillResources(skill: LoadedSkill): LoadedSkill {
   return { ...skill, resources: kept, body: `${skill.body}\n\n${lines.join("\n")}` };
 }
 
-function catalogSkillSource(binding: PiSkillBinding): SkillSource {
+function catalogSkillSource(
+  binding: PiSkillBinding,
+  transformSkillBody: RuntimeSkillBodyTransform | undefined,
+  availableToolNames: readonly string[],
+): SkillSource {
   const source = binding.source;
   return {
     id: source.id,
@@ -132,7 +138,17 @@ function catalogSkillSource(binding: PiSkillBinding): SkillSource {
     load: async (name) => {
       const skill = await source.load(name);
       if (!skill) return null;
-      const loaded = budgetSkillResources(skill);
+      const prepared = transformSkillBody
+        ? {
+            ...skill,
+            body: transformSkillBody({
+              name: skill.name,
+              body: skill.body,
+              availableToolNames,
+            }),
+          }
+        : skill;
+      const loaded = budgetSkillResources(prepared);
       const hasOversizedResource = skill.resources?.some((resource) =>
         typeof resource.size === "number" &&
         resource.size > SKILL_RESOURCE_BUDGET_BYTES
@@ -420,8 +436,14 @@ export async function skillPiToolCandidates(
 ): Promise<PiToolCandidate[]> {
   if (bindings.length === 0) return [];
 
+  const availableToolNames = (options.tools ?? []).map(({ tool }) => tool.name);
+
   const registry = new SkillRegistry(
-    bindings.map(catalogSkillSource),
+    bindings.map((binding) => catalogSkillSource(
+      binding,
+      options.transformSkillBody,
+      availableToolNames,
+    )),
     scriptRunner(bindings, options),
   );
   await registry.load();

package/src/runtime-assembler.ts

@@ -44,6 +44,7 @@ import type {
   RuntimeSettings,
   RuntimeExtensionContribution,
   RuntimeProfileContribution,
+  RuntimeSkillBodyTransform,
   RuntimeSkillContribution,
   RuntimeToolSurfacePolicy,
 } from "./runtime-definition";
@@ -90,6 +91,7 @@ export interface RuntimeAssemblyInput {
   readonly sandbox?: RuntimeSandboxPort;
   readonly memory?: RuntimeMemoryPort;
   readonly hostTools: readonly PiToolCandidate[];
+  readonly transformSkillBody?: RuntimeSkillBodyTransform;
   readonly skills: readonly RuntimeSkillContribution[];
   readonly connectors: readonly RuntimeMcpServer[];
   readonly gateway?: RuntimeGatewayPort;
@@ -168,6 +170,7 @@ interface ToolSurfaceInput {
     readonly profile: RuntimeMemoryProfile;
   };
   readonly hostTools: readonly PiToolCandidate[];
+  readonly transformSkillBody?: RuntimeSkillBodyTransform;
   readonly skills: readonly RuntimeSkillSourceBinding[];
   readonly enabledSubagents: readonly string[];
   readonly webSearch?: Parameters<typeof basePiToolCandidates>[0];
@@ -236,6 +239,9 @@ async function createToolSurface(
       loader: input.platform.loader,
       ...(input.workspace ? { workspace: input.workspace } : {}),
       tools: scriptCandidates,
+      ...(input.transformSkillBody
+        ? { transformSkillBody: input.transformSkillBody }
+        : {}),
     })),
     ...baseCandidates,
     ...memoryCandidates,
@@ -369,6 +375,7 @@ class RuntimeBuilder {
   private memoryProfile: RuntimeMemoryProfile = DISABLED_MEMORY;
   private memory?: RuntimeMemoryPort;
   private readonly hostTools: PiToolCandidate[] = [];
+  private transformSkillBody?: RuntimeSkillBodyTransform;
   private toolPolicy?: RuntimeToolSurfacePolicy;
   private readonly skillSources = new Map<
     string,
@@ -404,6 +411,7 @@ class RuntimeBuilder {
     this.memoryProfile = input.memoryProfile;
     this.memory = input.memory;
     this.hostTools.push(...input.hostTools);
+    this.transformSkillBody = input.transformSkillBody;
     this.toolPolicy = input.toolPolicy;
     for (const skill of input.skills) this.addSkill(skill);
     for (const connector of input.connectors) this.addConnector(connector);
@@ -619,6 +627,9 @@ class RuntimeBuilder {
           [...this.enabledSubagents],
         ),
       ],
+      ...(this.transformSkillBody
+        ? { transformSkillBody: this.transformSkillBody }
+        : {}),
       skills: skillSources,
       enabledSubagents: [...this.enabledSubagents],
       ...(webSearch ? { webSearch } : {}),
@@ -786,6 +797,9 @@ export async function assembleRuntimeSnapshot<
       ? { subagents: toolAssembly.bindings.subagents }
       : {}),
     hostTools,
+    ...(resources.transformSkillBody
+      ? { transformSkillBody: resources.transformSkillBody }
+      : {}),
     skills:
       input.ctx.role === "primary" && toolAssembly.bindings?.workspace
         ? [...BUILT_IN_RUNTIME_SKILLS, ...resources.skills]

package/src/runtime-definition.ts

@@ -82,12 +82,19 @@ export interface ResolvedConnectors {
   readonly degradations: readonly RuntimeDegradation[];
 }
 
+export type RuntimeSkillBodyTransform = (input: {
+  readonly name: string;
+  readonly body: string;
+  readonly availableToolNames: readonly string[];
+}) => string;
+
 export interface ResolvedResources {
   readonly settings: RuntimeSettings;
   readonly provider: RuntimeProviderPort;
   readonly platform: RuntimePlatformPort;
   readonly turnEvents?: RuntimeTurnEventsPort;
   readonly admission?: RuntimeSubmissionAdmissionHook;
+  readonly transformSkillBody?: RuntimeSkillBodyTransform;
   readonly skills: readonly RuntimeSkillContribution[];
   readonly extensions: readonly RuntimeExtensionContribution[];
   readonly connectors: ResolvedConnectors;