@xrkseek/harness 0.1.26

package/node_modules/@xrkseek/workspace/dist/durable-inject.js

@@ -0,0 +1,163 @@
+/**
+ * DSH-aligned durable workspace injects: skill catalog + agent instructions
+ * as model-visible `user/message` payloads (not system workspaceBlocks).
+ */
+import { createHash } from "node:crypto";
+import { clipToBudget } from "./inject-budget.js";
+export function digestWorkspaceText(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex").slice(0, 16);
+}
+export function budgetEventsToTruncations(events) {
+    return events.map((e) => ({
+        section: e.section,
+        originalChars: e.originalChars,
+        keptChars: e.keptChars,
+    }));
+}
+/** DSH-shaped model-facing skill catalog (progressive disclosure). */
+export function formatAvailableSkillsXml(skills) {
+    const listed = skills.filter((s) => s.modelInvocable);
+    const lines = listed.map((s) => `- \`${s.name}\`: ${s.description}`);
+    return [
+        "<system-reminder>",
+        "<available_skills>",
+        ...lines,
+        "</available_skills>",
+        "Use the skill tool with the exact skill name to load full instructions before acting on a matching task.",
+        "</system-reminder>",
+    ].join("\n");
+}
+export function buildSkillCatalogPayload(skills, budget, options) {
+    const listed = skills.filter((s) => s.modelInvocable);
+    if (listed.length === 0)
+        return undefined;
+    const full = formatAvailableSkillsXml(listed);
+    const content = clipToBudget("skills", full, budget, {
+        suffix: "\n[skill catalog truncated]",
+    });
+    if (!content.trim())
+        return undefined;
+    const included = listedForClippedCatalog(listed, content);
+    const skillBudget = budget.events.filter((e) => e.section === "skills");
+    const truncations = budgetEventsToTruncations(skillBudget);
+    const digest = digestWorkspaceText(content);
+    return {
+        content,
+        digest,
+        source: {
+            kind: "skill-catalog",
+            form: "catalog",
+            entries: included.map((s) => ({
+                name: s.name,
+                description: s.description,
+            })),
+            digest,
+            ...(options?.update ? { update: true } : {}),
+            ...(truncations.length > 0 ? { budgetTruncations: truncations } : {}),
+        },
+    };
+}
+function listedForClippedCatalog(listed, content) {
+    return listed.filter((s) => content.includes(`\`${s.name}\``));
+}
+export function buildInstructionsPayload(blocks, changes, budgetEvents) {
+    const content = blocks.join("\n\n").trim();
+    if (!content)
+        return undefined;
+    const instructionBudget = budgetEvents.filter((e) => e.section !== "skills");
+    const truncations = budgetEventsToTruncations(instructionBudget);
+    const digest = digestWorkspaceText(content);
+    return {
+        content,
+        digest,
+        source: {
+            kind: "agent-instructions",
+            form: "instructions",
+            changes: changes.length > 0 ? [...changes] : [{ action: "set" }],
+            digest,
+            ...(truncations.length > 0 ? { budgetTruncations: truncations } : {}),
+        },
+    };
+}
+/** Last-wins digests from durable inject `user/message` events. */
+export function foldLatestWorkspaceInjectDigests(events) {
+    let skillCatalog;
+    let instructions;
+    for (let i = events.length - 1; i >= 0; i--) {
+        const ev = events[i];
+        if (ev === undefined || ev.type !== "user/message" || !ev.source)
+            continue;
+        if (skillCatalog === undefined
+            && ev.source.kind === "skill-catalog"
+            && ev.source.digest) {
+            skillCatalog = ev.source.digest;
+        }
+        else if (instructions === undefined
+            && ev.source.kind === "agent-instructions"
+            && ev.source.digest) {
+            instructions = ev.source.digest;
+        }
+        if (skillCatalog !== undefined && instructions !== undefined)
+            break;
+    }
+    return {
+        ...(skillCatalog !== undefined ? { skillCatalog } : {}),
+        ...(instructions !== undefined ? { instructions } : {}),
+    };
+}
+/**
+ * Decide which durable injects to append (digest change or first sighting).
+ * Empty catalog after a prior catalog appends a replacement empty row.
+ */
+export function planWorkspaceInjectAppends(input) {
+    const out = [];
+    const { durable, previous } = input;
+    if (durable.skillCatalog) {
+        const update = previous.skillCatalog !== undefined;
+        if (durable.skillCatalog.digest !== previous.skillCatalog) {
+            const source = update
+                ? { ...durable.skillCatalog.source, update: true }
+                : durable.skillCatalog.source;
+            out.push({ content: durable.skillCatalog.content, source });
+        }
+    }
+    else if (previous.skillCatalog !== undefined) {
+        const content = [
+            "<system-reminder>",
+            "<available_skills>",
+            "</available_skills>",
+            "</system-reminder>",
+        ].join("\n");
+        out.push({
+            content,
+            source: {
+                kind: "skill-catalog",
+                form: "catalog",
+                entries: [],
+                update: true,
+                digest: digestWorkspaceText(content),
+            },
+        });
+    }
+    if (durable.instructions) {
+        if (durable.instructions.digest !== previous.instructions) {
+            out.push({
+                content: durable.instructions.content,
+                source: durable.instructions.source,
+            });
+        }
+    }
+    else if (previous.instructions !== undefined) {
+        out.push({
+            content: "(workspace instructions cleared)",
+            source: {
+                kind: "agent-instructions",
+                form: "instructions",
+                changes: [{ action: "clear" }],
+                digest: digestWorkspaceText("(workspace instructions cleared)"),
+            },
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=durable-inject.js.map

package/node_modules/@xrkseek/workspace/dist/durable-inject.js.map

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

package/node_modules/@xrkseek/workspace/dist/ecosystem-instructions.d.ts

@@ -0,0 +1,35 @@
+import type { InstructionChange } from "./durable-inject.js";
+import { type InjectBudget } from "./inject-budget.js";
+export interface InstructionSection {
+    /** Stable path for `changes[]` and section headers (posix-style). */
+    readonly path: string;
+    readonly body: string;
+}
+export interface CollectEcosystemInstructionsOptions {
+    readonly root: string;
+    readonly productDir: string;
+    readonly budget: InjectBudget;
+    /**
+     * Also inject user-home convention paths (`~/.agents`, `~/.xrk`, …).
+     * Default true — lower priority than workspace; workspace wins on duplicate body.
+     */
+    readonly includeUserHome?: boolean;
+    /** Test override for user-home root (default `os.homedir()`). */
+    readonly homeDir?: string;
+}
+/**
+ * Gather agent instruction markdown from multi-vendor convention paths.
+ * Policy: {@link HOME_CONVENTION_INJECT} · {@link WORKSPACE_CONVENTION_INJECT} in `inject-sources.ts`.
+ * Low → high priority in output order (later sections appear closer to the turn):
+ *
+ * 1. User home when `includeUserHome`
+ * 2. Workspace convention paths
+ * 3. Workspace `{productDir}` (default `.xrk/`)
+ * 4. Workspace root `AGENTS.md` / `CLAUDE.md` (unless product overlay exists)
+ *
+ * Skills trees are handled separately (skill catalog).
+ */
+export declare function collectEcosystemInstructions(options: CollectEcosystemInstructionsOptions): Promise<InstructionSection[]>;
+export declare function sectionsToInstructionBlocks(sections: readonly InstructionSection[]): string[];
+export declare function sectionsToInstructionChanges(sections: readonly InstructionSection[]): InstructionChange[];
+//# sourceMappingURL=ecosystem-instructions.d.ts.map

package/node_modules/@xrkseek/workspace/dist/ecosystem-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-instructions.d.ts","sourceRoot":"","sources":["../src/ecosystem-instructions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyTD;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA6D/B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,MAAM,EAAE,CAEV;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,iBAAiB,EAAE,CAKrB"}

package/node_modules/@xrkseek/workspace/dist/ecosystem-instructions.js

@@ -0,0 +1,256 @@
+import { access, readdir, readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { HOME_CONVENTION_INJECT, WORKSPACE_CONVENTION_INJECT, } from "./inject-sources.js";
+import { boundInstructionFile, clipToBudget, } from "./inject-budget.js";
+import { DEFAULT_MARKDOWN_DIR_MAX_DEPTH, nextScanDepth, shouldSkipScanDir, } from "./scan-guards.js";
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readIfExists(p) {
+    try {
+        const raw = await readFile(p, "utf8");
+        return boundInstructionFile(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function stripMdcFrontmatter(raw) {
+    const body = raw.replace(/^\uFEFF/, "");
+    if (!body.startsWith("---"))
+        return body;
+    const end = body.indexOf("\n---", 3);
+    if (end <= 0)
+        return body;
+    return body.slice(end + 4).replace(/^\r?\n/, "");
+}
+/** Frontmatter gate: `xrk-inject: false` skips Host product inject (Cursor may still read the rule). */
+function mdcHostInjectEnabled(raw) {
+    const body = raw.replace(/^\uFEFF/, "");
+    if (!body.startsWith("---"))
+        return true;
+    const end = body.indexOf("\n---", 3);
+    if (end <= 0)
+        return true;
+    const fm = body.slice(3, end);
+    return !/^xrk-inject:\s*false\s*$/im.test(fm);
+}
+function isAgentsImportOnly(text) {
+    const trimmed = text.trim();
+    return /^@AGENTS\.md\s*$/i.test(trimmed);
+}
+async function pushFile(sections, absPath, logicalPath, budget, seen) {
+    const raw = await readIfExists(absPath);
+    if (!raw?.trim())
+        return;
+    const digest = raw.trim();
+    if (seen.has(digest))
+        return;
+    const clipped = clipToBudget(logicalPath, raw, budget);
+    if (!clipped.trim())
+        return;
+    seen.add(digest);
+    sections.push({ path: logicalPath, body: clipped });
+}
+async function pushMarkdownDir(sections, dir, prefix, budget, seen, depth, options) {
+    if (budget.left <= 0)
+        return;
+    if (!(await exists(dir)))
+        return;
+    const names = (await readdir(dir)).sort();
+    for (const name of names) {
+        if (shouldSkipScanDir(name))
+            continue;
+        const abs = path.join(dir, name);
+        let entryStat;
+        try {
+            entryStat = await stat(abs);
+        }
+        catch {
+            continue;
+        }
+        if (entryStat.isDirectory()) {
+            const nextDepth = nextScanDepth(depth, DEFAULT_MARKDOWN_DIR_MAX_DEPTH);
+            if (nextDepth === null)
+                continue;
+            await pushMarkdownDir(sections, abs, `${prefix}${name}/`, budget, seen, nextDepth, options);
+            continue;
+        }
+        if (!/\.(md|mdc|markdown)$/i.test(name))
+            continue;
+        const raw = await readIfExists(abs);
+        if (!raw?.trim())
+            continue;
+        if (name.endsWith(".mdc") && !mdcHostInjectEnabled(raw))
+            continue;
+        let body = raw;
+        if (options?.stripMdc || name.endsWith(".mdc")) {
+            body = stripMdcFrontmatter(raw);
+        }
+        if (!body.trim())
+            continue;
+        const logical = `${prefix}${name}`.replace(/\\/g, "/");
+        const digest = body.trim();
+        if (seen.has(digest))
+            continue;
+        const clipped = clipToBudget(logical, body, budget);
+        if (!clipped.trim())
+            continue;
+        seen.add(digest);
+        sections.push({ path: logical, body: clipped });
+    }
+}
+const PRODUCT_STANDING_FILES = [
+    "SOUL.md",
+    "USER.md",
+    "IDENTITY.md",
+    "TOOLS.md",
+    "AGENTS.md",
+];
+/** Multi-vendor convention paths under one base directory. */
+async function pushConventionLayer(sections, base, logicalPrefix, budget, seen, profile) {
+    const lp = (suffix) => logicalPrefix ? `${logicalPrefix}${suffix}` : suffix;
+    if (profile.codexAgents) {
+        await pushFile(sections, path.join(base, ".codex", "AGENTS.md"), lp(".codex/AGENTS.md"), budget, seen);
+    }
+    if (profile.codexRootMd) {
+        await pushFile(sections, path.join(base, "CODEX.md"), lp("CODEX.md"), budget, seen);
+    }
+    if (profile.claude) {
+        await pushFile(sections, path.join(base, ".claude", "CLAUDE.md"), lp(".claude/CLAUDE.md"), budget, seen);
+        await pushMarkdownDir(sections, path.join(base, ".claude", "rules"), lp(".claude/rules/"), budget, seen, 0);
+    }
+    if (profile.agents) {
+        await pushFile(sections, path.join(base, ".agents", "AGENTS.md"), lp(".agents/AGENTS.md"), budget, seen);
+        await pushMarkdownDir(sections, path.join(base, ".agents", "rules"), lp(".agents/rules/"), budget, seen, 0);
+        const agentsCtxDir = path.join(base, ".agents", "context");
+        if (await exists(agentsCtxDir)) {
+            const files = (await readdir(agentsCtxDir)).sort();
+            for (const f of files) {
+                await pushFile(sections, path.join(agentsCtxDir, f), lp(`.agents/context/${f}`), budget, seen);
+            }
+        }
+    }
+    if (profile.cursorRules) {
+        await pushMarkdownDir(sections, path.join(base, ".cursor", "rules"), lp(".cursor/rules/"), budget, seen, 0, { stripMdc: true });
+    }
+    if (profile.github) {
+        await pushFile(sections, path.join(base, ".github", "copilot-instructions.md"), lp(".github/copilot-instructions.md"), budget, seen);
+        await pushMarkdownDir(sections, path.join(base, ".github", "instructions"), lp(".github/instructions/"), budget, seen, 0);
+    }
+}
+async function pushProductStanding(sections, productDir, logicalPrefix, budget, seen) {
+    if (!(await exists(productDir)))
+        return;
+    for (const name of PRODUCT_STANDING_FILES) {
+        await pushFile(sections, path.join(productDir, name), `${logicalPrefix}${name}`, budget, seen);
+    }
+    const assistant = (await readIfExists(path.join(productDir, "assistant.md"))) ??
+        (await readIfExists(path.join(productDir, "ASSISTANT.md")));
+    if (assistant?.trim()) {
+        const assistantPath = (await exists(path.join(productDir, "assistant.md")))
+            ? `${logicalPrefix}assistant.md`
+            : `${logicalPrefix}ASSISTANT.md`;
+        const clipped = clipToBudget(assistantPath, assistant, budget);
+        if (clipped.trim()) {
+            const digest = clipped.trim();
+            if (!seen.has(digest)) {
+                seen.add(digest);
+                sections.push({ path: assistantPath, body: clipped });
+            }
+        }
+    }
+    const ctxDir = path.join(productDir, "context");
+    if (await exists(ctxDir)) {
+        const files = (await readdir(ctxDir)).sort();
+        for (const f of files) {
+            await pushFile(sections, path.join(ctxDir, f), `${logicalPrefix}context/${f}`, budget, seen);
+        }
+    }
+    const rules = (await readIfExists(path.join(productDir, "rules.md"))) ??
+        (await readIfExists(path.join(productDir, "RULES.md")));
+    if (rules?.trim()) {
+        const rulesPath = (await exists(path.join(productDir, "rules.md")))
+            ? `${logicalPrefix}rules.md`
+            : `${logicalPrefix}RULES.md`;
+        const clipped = clipToBudget(rulesPath, rules, budget);
+        if (clipped.trim()) {
+            const digest = clipped.trim();
+            if (!seen.has(digest)) {
+                seen.add(digest);
+                sections.push({ path: rulesPath, body: clipped });
+            }
+        }
+    }
+    const subagents = await readIfExists(path.join(productDir, "subagents.md"));
+    if (subagents?.trim()) {
+        const clipped = clipToBudget(`${logicalPrefix}subagents.md`, subagents, budget);
+        if (clipped.trim()) {
+            const digest = clipped.trim();
+            if (!seen.has(digest)) {
+                seen.add(digest);
+                sections.push({ path: `${logicalPrefix}subagents.md`, body: clipped });
+            }
+        }
+    }
+}
+/**
+ * Gather agent instruction markdown from multi-vendor convention paths.
+ * Policy: {@link HOME_CONVENTION_INJECT} · {@link WORKSPACE_CONVENTION_INJECT} in `inject-sources.ts`.
+ * Low → high priority in output order (later sections appear closer to the turn):
+ *
+ * 1. User home when `includeUserHome`
+ * 2. Workspace convention paths
+ * 3. Workspace `{productDir}` (default `.xrk/`)
+ * 4. Workspace root `AGENTS.md` / `CLAUDE.md` (unless product overlay exists)
+ *
+ * Skills trees are handled separately (skill catalog).
+ */
+export async function collectEcosystemInstructions(options) {
+    const root = path.resolve(options.root);
+    const productDir = path.resolve(options.productDir);
+    const sections = [];
+    const seen = new Set();
+    const includeUserHome = options.includeUserHome !== false;
+    if (includeUserHome) {
+        const home = path.resolve(options.homeDir ?? homedir());
+        await pushConventionLayer(sections, home, "~/", options.budget, seen, HOME_CONVENTION_INJECT);
+        await pushProductStanding(sections, path.join(home, ".xrk"), "~/.xrk/", options.budget, seen);
+    }
+    await pushConventionLayer(sections, root, "", options.budget, seen, WORKSPACE_CONVENTION_INJECT);
+    await pushProductStanding(sections, productDir, ".xrk/", options.budget, seen);
+    const productAgents = await readIfExists(path.join(productDir, "AGENTS.md"));
+    const agentsAgents = await readIfExists(path.join(root, ".agents", "AGENTS.md"));
+    if (!productAgents?.trim() && !agentsAgents?.trim()) {
+        await pushFile(sections, path.join(root, "AGENTS.md"), "AGENTS.md", options.budget, seen);
+    }
+    const claudeRoot = await readIfExists(path.join(root, "CLAUDE.md"));
+    if (claudeRoot?.trim() && !isAgentsImportOnly(claudeRoot)) {
+        const clipped = clipToBudget("CLAUDE.md", claudeRoot, options.budget);
+        if (clipped.trim()) {
+            const digest = clipped.trim();
+            if (!seen.has(digest)) {
+                seen.add(digest);
+                sections.push({ path: "CLAUDE.md", body: clipped });
+            }
+        }
+    }
+    return sections;
+}
+export function sectionsToInstructionBlocks(sections) {
+    return sections.map((s) => `## ${s.path}\n${s.body}`);
+}
+export function sectionsToInstructionChanges(sections) {
+    return sections.map((s) => ({
+        action: "merge",
+        path: s.path,
+    }));
+}
+//# sourceMappingURL=ecosystem-instructions.js.map

package/node_modules/@xrkseek/workspace/dist/ecosystem-instructions.js.map

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

package/node_modules/@xrkseek/workspace/dist/index.d.ts

@@ -0,0 +1,85 @@
+import { type WorkspaceBudgetEvent, type WorkspaceDurableInject, type WorkspaceInjectAppend } from "./durable-inject.js";
+export type { WorkspaceBudgetEvent } from "./durable-inject.js";
+export type WorkspaceInjectResult = WorkspaceDurableInject;
+export interface WorkspaceInjector {
+    inject(options?: {
+        maxChars?: number;
+    }): Promise<WorkspaceInjectResult>;
+    /** Drop memoized inject (tests / hot reload). */
+    clearCache(): void;
+    /**
+     * True when inject roots match the last successful `inject()` fingerprint
+     * (Codex session cache / DSH digest fast path).
+     */
+    isDiskUnchanged(): Promise<boolean>;
+}
+export interface WorkspaceInjectorOptions {
+    readonly root: string;
+    /** Product inject overlay — default `{root}/.xrk` (see ecosystem paths). */
+    readonly productDir?: string;
+    /** Include user-home global layer for instructions (default true). */
+    readonly includeUserHome?: boolean;
+    /**
+     * Include `~/…/skills` in the durable skill-catalog inject (default **false**).
+     * Codex / DSH progressive disclosure: home skills stay reachable via the
+     * `skill` tool / `skill.list`; the standing catalog is workspace-scoped so
+     * hundreds of home skills do not re-enter every turn.
+     */
+    readonly includeUserHomeSkills?: boolean;
+    /** Test override for user-home root. */
+    readonly homeDir?: string;
+}
+/**
+ * Multi-vendor instruction paths + skill catalog (see `ecosystem-instructions.ts`
+ * and `docs/workspace-inject.md`). Durable: agent-instructions + skill-catalog
+ * as separate `user/message` payloads; `blocks` kept for previewInject only.
+ */
+export declare function createWorkspaceInjector(options: WorkspaceInjectorOptions): WorkspaceInjector;
+/** Test helper: assert root AGENTS.md path is not used as productDir default. */
+export declare function isProductInjectPath(root: string, candidate: string): boolean;
+export { applyRecipe, loadOfficeRecipes, loadRecipeFile, parseRecipeYaml, type Recipe, type RecipeParam, } from "./recipes.js";
+export { createSlashResolver, mapSlashRestToValues, parseSlashCommand, tryApplySlashRecipe, tryApplySlashSkill, type SlashCommand, type SlashRecipeResult, } from "./slash.js";
+export { HOME_CONVENTION_INJECT, HOME_INSTRUCTION_FINGERPRINT_MARKERS, SKILL_VENDOR_PRIORITY, USER_HOME_SKILL_REL_DIRS, WORKSPACE_CONVENTION_INJECT, WORKSPACE_INSTRUCTION_FINGERPRINT_MARKERS, WORKSPACE_SKILL_REL_DIRS, type ConventionInjectProfile, } from "./inject-sources.js";
+export { PROJECT_SKILL_REL_DIRS, USER_SKILL_REL_DIRS, formatSkillCatalog, isSkillName, listSkills, listSkillsFromWorkspace, listSkillsInDir, loadSkill, parseSkillMarkdown, renderSkillContent, resolveSkillDirs, SKILL_TOOL_GUIDANCE, type SkillDefinition, type SkillSourceOptions, type SkillSummary, } from "./skills.js";
+export { createSkillTools, presentSkillCall } from "./skill-tools.js";
+export { createWorkspaceToolOutputPersist, type WorkspaceToolOutputPersist, type WorkspaceToolOutputPersistOptions, } from "./tool-output-persist.js";
+export { buildInstructionsPayload, buildSkillCatalogPayload, budgetEventsToTruncations, digestWorkspaceText, foldLatestWorkspaceInjectDigests, formatAvailableSkillsXml, planWorkspaceInjectAppends, type DurableInstructionsPayload, type DurableSkillCatalogPayload, type InstructionChange, type LatestWorkspaceInjectDigests, type WorkspaceDurableInject, type WorkspaceInjectAppend, } from "./durable-inject.js";
+/**
+ * Options for resolving product-workspace injects.
+ * Default product dir: `{root}/.xrk` plus ecosystem convention paths.
+ */
+export interface ResolveWorkspaceInjectOptions {
+    readonly root: string;
+    readonly productDir?: string;
+    readonly maxChars?: number;
+    /** Sidebar workspace title — injected as display-only (not a path). */
+    readonly displayTitle?: string;
+}
+export interface ResolvedWorkspaceInject {
+    readonly injector: WorkspaceInjector;
+    readonly blocks: readonly string[];
+    readonly instructionBlocks: readonly string[];
+    readonly events: readonly WorkspaceBudgetEvent[];
+    readonly durable: WorkspaceDurableInject;
+}
+/**
+ * Create injector, then resolve durable + preview blocks.
+ * Presets call this once per createAgent(); durable injects append at turn start.
+ */
+export declare function resolveWorkspaceInject(options: ResolveWorkspaceInjectOptions, existingInjector?: WorkspaceInjector): Promise<ResolvedWorkspaceInject>;
+/** Append durable workspace injects when digests changed (turn boundary). */
+export declare function appendWorkspaceInjectsIfChanged(input: {
+    readonly store: {
+        get(sessionId: string): {
+            readonly events: readonly import("@xrkseek/protocol").SessionEvent[];
+        };
+        append(sessionId: string, event: import("@xrkseek/protocol").SessionEvent): unknown;
+    };
+    readonly sessionId: string;
+    readonly turnId: string;
+    readonly now: () => number;
+    readonly injectOptions: ResolveWorkspaceInjectOptions;
+    /** Reuse preset injector so inject is memoized across turns (DSH digest path). */
+    readonly injector?: WorkspaceInjector;
+}): Promise<readonly WorkspaceInjectAppend[]>;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/workspace/dist/index.d.ts.map

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