experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/sessions/run-session.js

@@ -0,0 +1,297 @@
+import { createBundledRuntimeCompiledArtifactsSource, } from "../compiled-artifacts-source.js";
+import { isAwaitingRuntimeActions } from "../harness/contracts.js";
+import { createNextUserMessageSessionWait } from "./types.js";
+/**
+ * Opens a new runtime session or hydrates an existing waiting session for the next turn.
+ */
+export function openOrHydrateRuntimeSession(input) {
+    if (input.session === null) {
+        return createRuntimeSession(input.runId, input.compiledArtifactsSource ?? createBundledRuntimeCompiledArtifactsSource(), input.parent);
+    }
+    if (input.session.status !== "waiting") {
+        return input.session;
+    }
+    return {
+        ...input.session,
+        status: "running",
+        wait: null,
+    };
+}
+/**
+ * Persists the serializable session state after one harness turn completes or fails.
+ */
+export function persistRuntimeSessionTurn(input) {
+    return {
+        ...input.session,
+        harnessState: input.outcome.checkpoint,
+        history: [...input.outcome.projection.history],
+        lastTurn: createRuntimeTurnState(input.turn, input.outcome),
+        status: getRuntimeSessionStatus(input.outcome),
+        turnCount: input.turn.sequence,
+        wait: null,
+    };
+}
+/**
+ * Marks the session as parked on the only supported v1 between-turn wait.
+ */
+export function parkRuntimeSessionOnNextUserMessage(session) {
+    return {
+        ...session,
+        status: "waiting",
+        wait: createNextUserMessageSessionWait(),
+    };
+}
+/**
+ * Runs one prepared runtime turn through any intermediate runtime-action
+ * pauses, then persists the resulting session snapshot.
+ */
+export async function runSingleTurnRuntimeSession(input, dependencies) {
+    const result = await runRuntimeSessionEngine({
+        compiledArtifactsSource: input.compiledArtifactsSource,
+        initialMessage: input.message,
+        mode: "single-turn",
+        runId: input.runId,
+        session: input.session ?? null,
+    }, dependencies);
+    return {
+        assistantMessage: result.assistantMessage,
+        outcome: result.outcome,
+        runId: result.runId,
+        session: result.session,
+        status: result.status,
+        turn: result.turn,
+    };
+}
+/**
+ * Runs the durable runtime session loop until the session either fails or completes-final.
+ */
+export async function runRuntimeSession(input, dependencies) {
+    const result = await runRuntimeSessionEngine({
+        compiledArtifactsSource: input.compiledArtifactsSource,
+        initialMessage: input.initialMessage,
+        mode: "multi-turn",
+        runId: input.runId,
+        session: input.session ?? null,
+    }, dependencies);
+    return {
+        assistantMessage: result.assistantMessage,
+        runId: result.runId,
+        session: result.session,
+        status: result.status,
+    };
+}
+function createRuntimeSession(runId, compiledArtifactsSource, parent = undefined) {
+    return {
+        activeSkillIds: [],
+        compiledArtifactsSource,
+        harnessState: {},
+        history: [],
+        lastTurn: null,
+        parent,
+        runId,
+        sandboxState: null,
+        sessionId: `session_${runId}`,
+        status: "running",
+        turnCount: 0,
+        wait: null,
+        workspaceState: null,
+    };
+}
+async function startRuntimeSessionTurn(input, dependencies) {
+    if (dependencies.prepareAndStartTurn !== undefined) {
+        return await dependencies.prepareAndStartTurn(input);
+    }
+    if (dependencies.prepareTurn === undefined || dependencies.startTurn === undefined) {
+        throw new Error("Expected runtime session dependencies to provide either prepareAndStartTurn or both prepareTurn and startTurn.");
+    }
+    const turn = await dependencies.prepareTurn(input);
+    return {
+        execution: await dependencies.startTurn({
+            session: input.session,
+            turn,
+        }),
+        turn,
+    };
+}
+async function runRuntimeSessionEngine(input, dependencies) {
+    const callbacks = dependencies.callbacks;
+    let nextMessage = input.initialMessage;
+    let session = await dependencies.openOrHydrateSession({
+        compiledArtifactsSource: input.compiledArtifactsSource,
+        runId: input.runId,
+        session: input.session,
+    });
+    await callbacks?.onRunStarted?.({
+        session,
+    });
+    while (true) {
+        const turnResult = await runRuntimeSessionTurn({
+            message: nextMessage,
+            session,
+        }, dependencies);
+        session = turnResult.session;
+        if (turnResult.outcome.status === "failed") {
+            await callbacks?.onRunFailed?.({
+                error: turnResult.outcome.error,
+                session,
+            });
+            return {
+                assistantMessage: null,
+                outcome: turnResult.outcome,
+                runId: session.runId,
+                session,
+                status: "failed",
+                turn: turnResult.turn,
+            };
+        }
+        if (shouldCompleteRuntimeSession(input.mode, turnResult.outcome)) {
+            await callbacks?.onRunCompleted?.({
+                session,
+            });
+            return {
+                assistantMessage: turnResult.outcome.projection.assistantOutput?.text ?? null,
+                outcome: turnResult.outcome,
+                runId: session.runId,
+                session,
+                status: "completed",
+                turn: turnResult.turn,
+            };
+        }
+        const waitDependencies = requireMultiTurnRuntimeSessionDependencies(input.mode, dependencies);
+        session = await waitDependencies.parkSession({
+            session,
+        });
+        await callbacks?.onSessionWaiting?.({
+            session,
+        });
+        nextMessage = await waitDependencies.waitForNextUserMessage({
+            session,
+        });
+        session = await dependencies.openOrHydrateSession({
+            compiledArtifactsSource: input.compiledArtifactsSource,
+            runId: input.runId,
+            session,
+        });
+    }
+}
+async function runRuntimeSessionTurn(input, dependencies) {
+    const callbacks = dependencies.callbacks;
+    const startedTurn = await startRuntimeSessionTurn(input, dependencies);
+    const turn = startedTurn.turn;
+    await callbacks?.onTurnStarted?.({
+        session: input.session,
+        turn,
+    });
+    await callbacks?.onMessageReceived?.({
+        message: turn.userMessage,
+        session: input.session,
+        turn,
+    });
+    let execution = startedTurn.execution;
+    let session = withRuntimeSessionWorkspaceState(input.session, execution.workspaceState);
+    session = withRuntimeSessionSandboxState(session, execution.sandboxState);
+    let outcome = execution.outcome;
+    session = withRuntimeSessionHarnessState(session, outcome.checkpoint);
+    while (isAwaitingRuntimeActions(outcome)) {
+        await callbacks?.onActionsRequested?.({
+            actions: outcome.actions,
+            session,
+            turn,
+        });
+        const actionExecution = await dependencies.executeActions({
+            actions: outcome.actions,
+            session,
+            turn,
+        });
+        session = actionExecution.session;
+        for (const result of actionExecution.results) {
+            await callbacks?.onActionResult?.({
+                result,
+                session,
+                turn,
+            });
+        }
+        execution = await dependencies.resumeTurn({
+            continuation: outcome.continuation,
+            results: actionExecution.results,
+            session,
+            turn,
+        });
+        session = withRuntimeSessionWorkspaceState(session, execution.workspaceState);
+        session = withRuntimeSessionSandboxState(session, execution.sandboxState);
+        outcome = execution.outcome;
+        session = withRuntimeSessionHarnessState(session, outcome.checkpoint);
+    }
+    session = await dependencies.persistTurn({
+        outcome,
+        session,
+        turn,
+    });
+    await callbacks?.onMessageCompleted?.({
+        outcome,
+        session,
+        turn,
+    });
+    await callbacks?.onTurnCompleted?.({
+        outcome,
+        session,
+        turn,
+    });
+    return {
+        outcome,
+        session,
+        turn,
+    };
+}
+function shouldCompleteRuntimeSession(mode, outcome) {
+    return mode === "single-turn" || outcome.completion === "session-final";
+}
+function requireMultiTurnRuntimeSessionDependencies(mode, dependencies) {
+    if (mode === "single-turn") {
+        throw new Error("Single-turn runtime sessions do not support waiting for the next message.");
+    }
+    if (dependencies.parkSession === undefined || dependencies.waitForNextUserMessage === undefined) {
+        throw new Error("Expected multi-turn runtime session dependencies to provide both parkSession and waitForNextUserMessage.");
+    }
+    return {
+        parkSession: dependencies.parkSession,
+        waitForNextUserMessage: dependencies.waitForNextUserMessage,
+    };
+}
+function withRuntimeSessionWorkspaceState(session, workspaceState) {
+    return {
+        ...session,
+        workspaceState,
+    };
+}
+function withRuntimeSessionSandboxState(session, sandboxState) {
+    return {
+        ...session,
+        sandboxState,
+    };
+}
+function withRuntimeSessionHarnessState(session, harnessState) {
+    return {
+        ...session,
+        harnessState,
+    };
+}
+function createRuntimeTurnState(turn, outcome) {
+    return {
+        assistantMessage: outcome.projection.assistantOutput?.text ?? null,
+        metadata: turn.metadata,
+        sequence: turn.sequence,
+        status: outcome.status === "failed" ? "failed" : "completed",
+        turnId: turn.turnId,
+        userMessage: turn.userMessage,
+    };
+}
+function getRuntimeSessionStatus(outcome) {
+    if (outcome.status === "failed") {
+        return "failed";
+    }
+    return outcome.status === "completed" && outcome.completion === "session-final"
+        ? "completed"
+        : "running";
+}
+//# sourceMappingURL=run-session.js.map

package/dist/src/runtime/sessions/run-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-session.js","sourceRoot":"","sources":["../../../../src/runtime/sessions/run-session.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/sessions/turn.d.ts

@@ -0,0 +1,94 @@
+import type { RuntimeModelReference } from "../agent/bootstrap.js";
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+import type { HarnessWorkspaceSpec } from "../harness/workspace/types.js";
+import type { JsonObject, JsonValue } from "../json.js";
+import type { RuntimeSandboxRegistry } from "../sandboxes/registry.js";
+import type { RuntimeSessionMessage } from "./messages.js";
+/**
+ * Common serializable metadata shared by every model-visible runtime tool.
+ */
+export interface PreparedRuntimeToolBase {
+    readonly description: string | null;
+    readonly inputSchema: JsonValue | null;
+    readonly logicalPath: string;
+    readonly name: string;
+    readonly sourceId: string;
+}
+/**
+ * Serializable authored tool descriptor prepared by the runtime for one
+ * harness turn.
+ */
+export interface PreparedRuntimeAuthoredTool extends PreparedRuntimeToolBase {
+    readonly kind: "authored-tool";
+}
+/**
+ * Serializable subagent descriptor prepared by the runtime for one harness
+ * turn.
+ */
+export interface PreparedRuntimeSubagentTool extends PreparedRuntimeToolBase {
+    readonly kind: "subagent";
+    readonly selector: string;
+    readonly subagentId: string;
+}
+/**
+ * Serializable authored sandbox descriptor prepared for one harness turn.
+ */
+export interface PreparedRuntimeSandbox {
+    readonly description: string | null;
+    readonly logicalPath: string;
+    readonly name: string;
+    readonly sourceId: string;
+    readonly toolName: string;
+}
+/**
+ * Serializable model-visible runtime tool prepared for one harness turn.
+ */
+export type PreparedRuntimeTool = PreparedRuntimeAuthoredTool | PreparedRuntimeSubagentTool;
+/**
+ * Serializable runtime-owned action tool descriptor prepared for one harness
+ * fragment.
+ */
+export interface PreparedRuntimeActionTool {
+    readonly actionKind: "activate-skill";
+    readonly description: string | null;
+    readonly inputSchema: JsonValue | null;
+    readonly name: string;
+}
+/**
+ * Serializable runtime-owned turn input consumed by the step-owned harness.
+ */
+export interface PreparedRuntimeTurn {
+    readonly agentSelector?: string;
+    readonly instructions: readonly string[];
+    readonly messages: readonly RuntimeSessionMessage[];
+    readonly metadata?: JsonObject;
+    readonly model: RuntimeModelReference;
+    readonly sandboxes: readonly PreparedRuntimeSandbox[];
+    readonly sequence: number;
+    readonly skills: readonly RuntimeSkillSource[];
+    readonly tools: readonly PreparedRuntimeTool[];
+    readonly turnId: string;
+    readonly userMessage: string;
+    readonly workspaceSpec: HarnessWorkspaceSpec;
+}
+/**
+ * Dynamic runtime-owned context derived from durable session state for one
+ * harness start or resume call.
+ */
+export interface RuntimeTurnContext {
+    readonly runtimeTools: readonly PreparedRuntimeActionTool[];
+    readonly sandboxRegistry?: RuntimeSandboxRegistry;
+    readonly systemInstructions: readonly string[];
+}
+/**
+ * Durable checkpoint for the latest runtime turn state.
+ */
+export interface RuntimeTurnState {
+    readonly assistantMessage: string | null;
+    readonly metadata?: JsonObject;
+    readonly sequence: number;
+    readonly status: "completed" | "failed" | "prepared" | "running";
+    readonly turnId: string;
+    readonly userMessage: string;
+}
+//# sourceMappingURL=turn.d.ts.map

package/dist/src/runtime/sessions/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../src/runtime/sessions/turn.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/sessions/turn.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turn.js.map

package/dist/src/runtime/sessions/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../../../../src/runtime/sessions/turn.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import type { RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { HarnessSessionState } from "../harness/types.js";
+import type { HarnessWorkspaceState } from "../harness/workspace/types.js";
+import type { JsonObject } from "../json.js";
+import type { RuntimeSandboxState } from "../sandboxes/types.js";
+import type { SessionParent } from "../session-context.js";
+import type { RuntimeSessionMessage } from "./messages.js";
+import type { RuntimeTurnState } from "./turn.js";
+/**
+ * The only between-turn wait supported by the v1 runtime session loop.
+ */
+export interface NextUserMessageSessionWait {
+    readonly kind: "next-user-message";
+}
+/**
+ * Zod schema for the supported v1 session wait shape.
+ */
+export declare const nextUserMessageSessionWaitSchema: z.ZodType<NextUserMessageSessionWait>;
+/**
+ * Runtime session waits deliberately exclude mailbox, approval, callback, and interrupt taxonomies.
+ */
+export type RuntimeSessionWait = NextUserMessageSessionWait;
+/**
+ * Zod schema for supported v1 runtime session waits.
+ */
+export declare const runtimeSessionWaitSchema: z.ZodType<RuntimeSessionWait>;
+/**
+ * Durable runtime-owned session state shared across workflow orchestration steps.
+ */
+export interface RuntimeSessionState {
+    /**
+     * Canonical runtime-owned active skill ids carried across turns.
+     */
+    readonly activeSkillIds: readonly string[];
+    /**
+     * Canonical runtime-owned source for the compiled artifacts used to resolve
+     * the agent graph across the entire session.
+     */
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    readonly harnessState: HarnessSessionState;
+    /**
+     * Canonical runtime-owned conversation history used to prepare the next turn.
+     */
+    readonly history: readonly RuntimeSessionMessage[];
+    /**
+     * Compact summary of the latest prepared or completed turn for diagnostics and status surfaces.
+     */
+    readonly lastTurn: RuntimeTurnState | null;
+    readonly metadata?: JsonObject;
+    /**
+     * Stable lineage metadata describing the immediate Ash parent session when
+     * this run was delegated by another Ash-owned execution.
+     */
+    readonly parent?: SessionParent;
+    readonly runId: string;
+    readonly sessionId: string;
+    readonly status: "completed" | "failed" | "running" | "waiting";
+    readonly sandboxState: RuntimeSandboxState | null;
+    readonly turnCount: number;
+    readonly wait: RuntimeSessionWait | null;
+    readonly workspaceState: HarnessWorkspaceState | null;
+}
+/**
+ * Creates the only supported v1 between-turn wait request.
+ */
+export declare function createNextUserMessageSessionWait(): NextUserMessageSessionWait;
+/**
+ * Validates unknown JSON against the v1 runtime session wait contract.
+ */
+export declare function isRuntimeSessionWait(value: unknown): value is RuntimeSessionWait;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/sessions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAIxE,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CACjC,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,0BAA0B,CAI7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF"}

package/dist/src/runtime/sessions/types.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/**
+ * Zod schema for the supported v1 session wait shape.
+ */
+export const nextUserMessageSessionWaitSchema = z
+    .object({
+    kind: z.literal("next-user-message"),
+})
+    .strict();
+/**
+ * Zod schema for supported v1 runtime session waits.
+ */
+export const runtimeSessionWaitSchema = nextUserMessageSessionWaitSchema;
+/**
+ * Creates the only supported v1 between-turn wait request.
+ */
+export function createNextUserMessageSessionWait() {
+    return {
+        kind: "next-user-message",
+    };
+}
+/**
+ * Validates unknown JSON against the v1 runtime session wait contract.
+ */
+export function isRuntimeSessionWait(value) {
+    return runtimeSessionWaitSchema.safeParse(value).success;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/runtime/sessions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/runtime/sessions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA0C,CAAC;KACrF,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;CACrC,CAAC;KACD,MAAM,EAAE,CAAC;AAOZ;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,gCAAgC,CAAC;AAuCnC;;GAEG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,IAAI,EAAE,mBAAmB;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC"}

package/dist/src/runtime/skills/fragment-context.d.ts

@@ -0,0 +1,26 @@
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+import type { RuntimeTurnContext } from "../sessions/turn.js";
+import type { LoadedRuntimeSkill } from "./types.js";
+/**
+ * Framework-owned tool name used to activate one available compiled skill.
+ */
+export declare const ACTIVATE_SKILL_TOOL_NAME = "activate_skill";
+/**
+ * Builds the runtime-owned fragment context for one harness start or resume
+ * call from the current skill state.
+ */
+export declare function createRuntimeSkillTurnContext(input: {
+    readonly activeSkills: readonly LoadedRuntimeSkill[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+    readonly baseInstructions: readonly string[];
+}): RuntimeTurnContext;
+/**
+ * Loads the active skill bodies and builds the runtime-owned fragment context
+ * for one harness start or resume call.
+ */
+export declare function loadRuntimeSkillTurnContext(input: {
+    readonly activeSkillIds: readonly string[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+    readonly baseInstructions: readonly string[];
+}): Promise<RuntimeTurnContext>;
+//# sourceMappingURL=fragment-context.d.ts.map

package/dist/src/runtime/skills/fragment-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-context.d.ts","sourceRoot":"","sources":["../../../../src/runtime/skills/fragment-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAA6B,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAiBzD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C,GAAG,kBAAkB,CAWrB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS9B"}

package/dist/src/runtime/skills/fragment-context.js

@@ -0,0 +1,94 @@
+import { loadActiveRuntimeSkills } from "./load-skill-content.js";
+/**
+ * Framework-owned tool name used to activate one available compiled skill.
+ */
+export const ACTIVATE_SKILL_TOOL_NAME = "activate_skill";
+const ACTIVATE_SKILL_TOOL_DESCRIPTION = "Load the full instructions for one available skill by name or id before relying on that skill.";
+const ACTIVATE_SKILL_TOOL_INPUT_SCHEMA = {
+    additionalProperties: false,
+    properties: {
+        skill: {
+            description: "Available skill name or id.",
+            type: "string",
+        },
+    },
+    required: ["skill"],
+    type: "object",
+};
+/**
+ * Builds the runtime-owned fragment context for one harness start or resume
+ * call from the current skill state.
+ */
+export function createRuntimeSkillTurnContext(input) {
+    const inactiveSkills = filterInactiveRuntimeSkills(input.availableSkills, input.activeSkills);
+    return {
+        runtimeTools: createRuntimeSkillActionTools(inactiveSkills),
+        systemInstructions: createRuntimeSkillInstructions({
+            activeSkills: input.activeSkills,
+            availableSkills: inactiveSkills,
+            baseInstructions: input.baseInstructions,
+        }),
+    };
+}
+/**
+ * Loads the active skill bodies and builds the runtime-owned fragment context
+ * for one harness start or resume call.
+ */
+export async function loadRuntimeSkillTurnContext(input) {
+    return createRuntimeSkillTurnContext({
+        activeSkills: await loadActiveRuntimeSkills({
+            activeSkillIds: input.activeSkillIds,
+            availableSkills: input.availableSkills,
+        }),
+        availableSkills: input.availableSkills,
+        baseInstructions: input.baseInstructions,
+    });
+}
+function createRuntimeSkillActionTools(availableSkills) {
+    if (availableSkills.length === 0) {
+        return [];
+    }
+    return [
+        {
+            actionKind: "activate-skill",
+            description: ACTIVATE_SKILL_TOOL_DESCRIPTION,
+            inputSchema: ACTIVATE_SKILL_TOOL_INPUT_SCHEMA,
+            name: ACTIVATE_SKILL_TOOL_NAME,
+        },
+    ];
+}
+function createRuntimeSkillInstructions(input) {
+    const instructions = [...input.baseInstructions];
+    const availableInstruction = createAvailableSkillsInstruction(input.availableSkills);
+    if (availableInstruction !== null) {
+        instructions.push(availableInstruction);
+    }
+    for (const skill of input.activeSkills) {
+        instructions.push(createActivatedSkillInstruction(skill));
+    }
+    return instructions;
+}
+function createAvailableSkillsInstruction(skills) {
+    if (skills.length === 0) {
+        return null;
+    }
+    const lines = [
+        "Available skills",
+        "Use the activate_skill tool to load a skill by name or id before following its full instructions.",
+        ...skills.map((skill) => createAvailableSkillLine(skill)),
+    ];
+    return lines.join("\n");
+}
+function createAvailableSkillLine(skill) {
+    return skill.name === skill.skillId
+        ? `- ${skill.name}: ${skill.description}`
+        : `- ${skill.name} [${skill.skillId}]: ${skill.description}`;
+}
+function filterInactiveRuntimeSkills(availableSkills, activeSkills) {
+    const activeSkillIds = new Set(activeSkills.map((skill) => skill.skillId));
+    return availableSkills.filter((skill) => !activeSkillIds.has(skill.skillId));
+}
+function createActivatedSkillInstruction(skill) {
+    return `Skill (${skill.skillId})\n${skill.markdown.trimEnd()}`;
+}
+//# sourceMappingURL=fragment-context.js.map

package/dist/src/runtime/skills/fragment-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-context.js","sourceRoot":"","sources":["../../../../src/runtime/skills/fragment-context.ts"],"names":[],"mappings":"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"}