openhorse 0.2.5 → 0.2.8

package/dist/core/checkpoint.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * openhorse - File Checkpoints
+ *
+ * Before editing files, create recoverable snapshots so the user can
+ * undo agent changes back to a specific turn.
+ *
+ * Storage: ~/.openhorse/projects/<project-key>/checkpoints/<turnId>/<file>
+ * TTL: 7 days
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECKPOINT_TTL_MS = void 0;
+exports.createCheckpoint = createCheckpoint;
+exports.restoreCheckpoint = restoreCheckpoint;
+exports.listCheckpoints = listCheckpoints;
+exports.cleanupCheckpoints = cleanupCheckpoints;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_dir_1 = require("../services/config-dir");
+exports.CHECKPOINT_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+function getCheckpointDir(projectPath) {
+    const dir = (0, config_dir_1.getProjectCheckpointsDir)(projectPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    return dir;
+}
+function getLegacyCheckpointDir(projectPath) {
+    return path.join((0, config_dir_1.getProjectSessionsDir)(projectPath), '_checkpoints');
+}
+function getTurnDir(projectPath, turnId) {
+    const base = getCheckpointDir(projectPath);
+    return path.join(base, `${turnId}`);
+}
+function getExistingTurnDir(projectPath, turnId) {
+    const canonical = path.join((0, config_dir_1.getProjectCheckpointsDir)(projectPath), `${turnId}`);
+    if (fs.existsSync(canonical))
+        return canonical;
+    const legacy = path.join(getLegacyCheckpointDir(projectPath), `${turnId}`);
+    if (fs.existsSync(legacy))
+        return legacy;
+    return canonical;
+}
+/**
+ * Create a checkpoint for the given files at the current state.
+ * Files are saved individually so they can be restored independently.
+ */
+function createCheckpoint(projectPath, turnId, filePaths) {
+    if (!projectPath || filePaths.length === 0)
+        return null;
+    const dir = getTurnDir(projectPath, turnId);
+    if (fs.existsSync(dir))
+        return null; // Already exists
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const files = [];
+    for (const filePath of filePaths) {
+        try {
+            if (!fs.existsSync(filePath))
+                continue;
+            const content = fs.readFileSync(filePath, 'utf8');
+            const relativePath = path.relative(projectPath, filePath);
+            const checkpointPath = path.join(dir, safeFileName(relativePath));
+            fs.mkdirSync(path.dirname(checkpointPath), { recursive: true });
+            fs.writeFileSync(checkpointPath, content, { mode: 0o600 });
+            files.push({
+                path: relativePath,
+                content: content.slice(0, 200), // Preview only
+                sizeBytes: Buffer.byteLength(content, 'utf8'),
+            });
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Write checkpoint metadata
+    const meta = { turnId, createdAt: Date.now(), files };
+    fs.writeFileSync(path.join(dir, '.checkpoint.json'), JSON.stringify(meta, null, 2), { mode: 0o600 });
+    return meta;
+}
+/**
+ * Restore a checkpoint — overwrite current files with checkpointed content.
+ * Returns the list of restored files.
+ */
+function restoreCheckpoint(projectPath, turnId) {
+    if (!projectPath)
+        return { restored: [], error: 'No project path' };
+    const dir = getExistingTurnDir(projectPath, turnId);
+    if (!fs.existsSync(dir)) {
+        return { restored: [], error: `No checkpoint found for turn ${turnId}` };
+    }
+    const metaPath = path.join(dir, '.checkpoint.json');
+    if (!fs.existsSync(metaPath)) {
+        return { restored: [], error: 'Checkpoint metadata missing' };
+    }
+    let meta;
+    try {
+        meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+    }
+    catch {
+        return { restored: [], error: 'Checkpoint metadata corrupted' };
+    }
+    const restored = [];
+    for (const file of meta.files) {
+        const checkpointFile = path.join(dir, safeFileName(file.path));
+        const targetFile = path.join(projectPath, file.path);
+        try {
+            if (!fs.existsSync(checkpointFile))
+                continue;
+            const content = fs.readFileSync(checkpointFile, 'utf8');
+            fs.mkdirSync(path.dirname(targetFile), { recursive: true });
+            fs.writeFileSync(targetFile, content, { mode: 0o600 });
+            restored.push(file.path);
+        }
+        catch {
+            // Skip files that can't be restored
+        }
+    }
+    return { restored };
+}
+/**
+ * List available checkpoints for a project.
+ */
+function listCheckpoints(projectPath) {
+    if (!projectPath)
+        return [];
+    const dirs = [getCheckpointDir(projectPath), getLegacyCheckpointDir(projectPath)];
+    const checkpointsByTurn = new Map();
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        for (const entry of fs.readdirSync(dir)) {
+            const metaPath = path.join(dir, entry, '.checkpoint.json');
+            if (fs.existsSync(metaPath)) {
+                try {
+                    const checkpoint = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+                    if (!checkpointsByTurn.has(checkpoint.turnId)) {
+                        checkpointsByTurn.set(checkpoint.turnId, checkpoint);
+                    }
+                }
+                catch {
+                    // Skip corrupted metadata
+                }
+            }
+        }
+    }
+    return Array.from(checkpointsByTurn.values()).sort((a, b) => b.createdAt - a.createdAt);
+}
+/**
+ * Clean up checkpoints older than the TTL (7 days).
+ */
+function cleanupCheckpoints(projectPath) {
+    if (!projectPath)
+        return 0;
+    const dirs = [getCheckpointDir(projectPath), getLegacyCheckpointDir(projectPath)];
+    let cleaned = 0;
+    const now = Date.now();
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        for (const entry of fs.readdirSync(dir)) {
+            if (entry === '.checkpoint.json')
+                continue; // Skip stray meta files
+            const entryPath = path.join(dir, entry);
+            try {
+                const stat = fs.statSync(entryPath);
+                if (!stat.isDirectory())
+                    continue;
+                // Check the meta file's mtime
+                const metaPath = path.join(entryPath, '.checkpoint.json');
+                if (fs.existsSync(metaPath)) {
+                    const metaStat = fs.statSync(metaPath);
+                    if (now - metaStat.mtimeMs > exports.CHECKPOINT_TTL_MS) {
+                        fs.rmSync(entryPath, { recursive: true, force: true });
+                        cleaned++;
+                    }
+                }
+            }
+            catch {
+                // Skip entries that can't be accessed
+            }
+        }
+    }
+    return cleaned;
+}
+function safeFileName(filePath) {
+    // Replace problematic characters in file names for safe storage
+    return filePath.replace(/[<>:"|?*]/g, '_');
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/core/checkpoint.js.map

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

package/dist/core/tool-artifacts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * openhorse - Tool Artifacts
+ *
+ * Store large tool outputs as disk artifacts instead of embedding them in
+ * session transcripts or harness evidence. Returns a reference ID that can
+ * be used to retrieve the full output later.
+ */
+/** Maximum output size before truncation + artifact storage (10KB) */
+export declare const ARTIFACT_THRESHOLD = 10240;
+export interface ToolArtifact {
+    /** Unique artifact reference ID */
+    id: string;
+    /** Size in bytes of the full output */
+    outputBytes: number;
+    /** Whether the output was truncated */
+    truncated: boolean;
+    /** Path to the artifact file on disk (relative to artifact dir) */
+    path: string;
+}
+/**
+ * Store a large output as an artifact file and return a reference.
+ * Returns null if the project path is not available (falls back to inline).
+ */
+export declare function storeArtifact(projectPath: string | undefined, toolName: string, output: string, outputBytes: number): ToolArtifact | null;
+/**
+ * Retrieve a stored artifact by path.
+ */
+export declare function retrieveArtifact(artifactPath: string): string | null;
+/**
+ * Truncate a large output for inline context display.
+ * Shows the first portion and last portion with an ellipsis in between.
+ */
+export declare function truncateForContext(output: string, maxBytes?: number): string;
+/**
+ * Clean up expired artifacts (older than 24h).
+ */
+export declare function cleanupArtifacts(projectPath: string): void;
+//# sourceMappingURL=tool-artifacts.d.ts.map

package/dist/core/tool-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-artifacts.d.ts","sourceRoot":"","sources":["../../src/core/tool-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAezC,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,YAAY,GAAG,IAAI,CAkBrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAS1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAmB1D"}

package/dist/core/tool-artifacts.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * openhorse - Tool Artifacts
+ *
+ * Store large tool outputs as disk artifacts instead of embedding them in
+ * session transcripts or harness evidence. Returns a reference ID that can
+ * be used to retrieve the full output later.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARTIFACT_THRESHOLD = void 0;
+exports.storeArtifact = storeArtifact;
+exports.retrieveArtifact = retrieveArtifact;
+exports.truncateForContext = truncateForContext;
+exports.cleanupArtifacts = cleanupArtifacts;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_dir_1 = require("../services/config-dir");
+/** Maximum output size before truncation + artifact storage (10KB) */
+exports.ARTIFACT_THRESHOLD = 10240;
+/** Directory for tool artifacts */
+function getArtifactDir(projectPath) {
+    const dir = (0, config_dir_1.getProjectArtifactsDir)(projectPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    return dir;
+}
+function getLegacyArtifactDir(projectPath) {
+    return path.join((0, config_dir_1.getProjectSessionsDir)(projectPath), '_artifacts');
+}
+/**
+ * Store a large output as an artifact file and return a reference.
+ * Returns null if the project path is not available (falls back to inline).
+ */
+function storeArtifact(projectPath, toolName, output, outputBytes) {
+    if (!projectPath)
+        return null;
+    const id = `${toolName}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const artifactDir = getArtifactDir(projectPath);
+    const artifactPath = path.join(artifactDir, `${id}.txt`);
+    try {
+        fs.writeFileSync(artifactPath, output, { mode: 0o600 });
+        return {
+            id,
+            outputBytes,
+            truncated: false,
+            path: artifactPath,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Retrieve a stored artifact by path.
+ */
+function retrieveArtifact(artifactPath) {
+    try {
+        if (!fs.existsSync(artifactPath))
+            return null;
+        return fs.readFileSync(artifactPath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Truncate a large output for inline context display.
+ * Shows the first portion and last portion with an ellipsis in between.
+ */
+function truncateForContext(output, maxBytes = 4096) {
+    const byteLen = Buffer.byteLength(output, 'utf8');
+    if (byteLen <= maxBytes)
+        return output;
+    const half = Math.floor(maxBytes / 2);
+    const buf = Buffer.from(output, 'utf8');
+    const head = buf.subarray(0, half).toString('utf8');
+    const tail = buf.subarray(buf.length - half).toString('utf8');
+    return `${head}\n\n[... ${byteLen - maxBytes} bytes truncated, ${byteLen}B total — see artifact for full output]\n\n${tail}`;
+}
+/**
+ * Clean up expired artifacts (older than 24h).
+ */
+function cleanupArtifacts(projectPath) {
+    const artifactDirs = [getArtifactDir(projectPath), getLegacyArtifactDir(projectPath)];
+    const now = Date.now();
+    for (const artifactDir of artifactDirs) {
+        if (!fs.existsSync(artifactDir))
+            continue;
+        const entries = fs.readdirSync(artifactDir);
+        for (const entry of entries) {
+            const fullPath = path.join(artifactDir, entry);
+            try {
+                const stat = fs.statSync(fullPath);
+                if (now - stat.mtimeMs > 24 * 60 * 60 * 1000) {
+                    fs.unlinkSync(fullPath);
+                }
+            }
+            catch {
+                // Best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=tool-artifacts.js.map

package/dist/core/tool-artifacts.js.map

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

package/dist/core/warn-dedup.d.ts

@@ -0,0 +1,39 @@
+/**
+ * openhorse - Warning Deduplication
+ *
+ * Suppresses repeated console warnings in CI and interactive sessions.
+ * Each unique warning key is emitted once, with a counter for subsequent
+ * identical warnings. On process exit or explicit flush, a summary line
+ * reports how many duplicates were suppressed.
+ *
+ * Usage:
+ *   import { warnOnce, flushWarnings } from '../core/warn-dedup';
+ *   warnOnce('sqlite-vec', '[VectorStore] sqlite-vec not available: ...');
+ */
+interface WarningCount {
+    message: string;
+    count: number;
+}
+/**
+ * Emit a warning only once per unique key. Subsequent calls with the same
+ * key are silently counted.
+ *
+ * @param key Stable identifier (e.g. 'sqlite-vec', 'skill-frontmatter')
+ * @param message Warning text (logged on first occurrence)
+ */
+export declare function warnOnce(key: string, message: string): void;
+/**
+ * Flush accumulated warning summary. Call once at session exit or test
+ * teardown. Returns the summary string (empty if no warnings were seen).
+ */
+export declare function flushWarnings(): string;
+/**
+ * Reset dedup state (for tests).
+ */
+export declare function resetWarnings(): void;
+/**
+ * Return the current dedup state for testing.
+ */
+export declare function getWarningState(): ReadonlyMap<string, WarningCount>;
+export {};
+//# sourceMappingURL=warn-dedup.d.ts.map

package/dist/core/warn-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-dedup.d.ts","sourceRoot":"","sources":["../../src/core/warn-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAKD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAW3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAsBtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAEnE"}

package/dist/core/warn-dedup.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * openhorse - Warning Deduplication
+ *
+ * Suppresses repeated console warnings in CI and interactive sessions.
+ * Each unique warning key is emitted once, with a counter for subsequent
+ * identical warnings. On process exit or explicit flush, a summary line
+ * reports how many duplicates were suppressed.
+ *
+ * Usage:
+ *   import { warnOnce, flushWarnings } from '../core/warn-dedup';
+ *   warnOnce('sqlite-vec', '[VectorStore] sqlite-vec not available: ...');
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.warnOnce = warnOnce;
+exports.flushWarnings = flushWarnings;
+exports.resetWarnings = resetWarnings;
+exports.getWarningState = getWarningState;
+const chalk_1 = __importDefault(require("chalk"));
+const _seen = new Map();
+let _flushed = false;
+/**
+ * Emit a warning only once per unique key. Subsequent calls with the same
+ * key are silently counted.
+ *
+ * @param key Stable identifier (e.g. 'sqlite-vec', 'skill-frontmatter')
+ * @param message Warning text (logged on first occurrence)
+ */
+function warnOnce(key, message) {
+    if (_flushed)
+        return;
+    const existing = _seen.get(key);
+    if (!existing) {
+        _seen.set(key, { message, count: 1 });
+        console.warn(chalk_1.default.yellow(`⚠ ${message}`));
+        return;
+    }
+    existing.count++;
+}
+/**
+ * Flush accumulated warning summary. Call once at session exit or test
+ * teardown. Returns the summary string (empty if no warnings were seen).
+ */
+function flushWarnings() {
+    if (_flushed || _seen.size === 0)
+        return '';
+    _flushed = true;
+    const lines = [];
+    let suppressed = 0;
+    for (const [, wc] of _seen) {
+        if (wc.count > 1) {
+            suppressed += wc.count - 1;
+            lines.push(`  [x${wc.count}] ${wc.message}`);
+        }
+    }
+    if (suppressed > 0) {
+        lines.unshift(chalk_1.default.yellow(`\n⚠ ${suppressed} duplicate warning(s) suppressed:`));
+        const summary = lines.join('\n');
+        console.warn(summary);
+        return summary;
+    }
+    return '';
+}
+/**
+ * Reset dedup state (for tests).
+ */
+function resetWarnings() {
+    _seen.clear();
+    _flushed = false;
+}
+/**
+ * Return the current dedup state for testing.
+ */
+function getWarningState() {
+    return _seen;
+}
+//# sourceMappingURL=warn-dedup.js.map

package/dist/core/warn-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-dedup.js","sourceRoot":"","sources":["../../src/core/warn-dedup.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;AAmBH,4BAWC;AAMD,sCAsBC;AAKD,sCAGC;AAKD,0CAEC;AAvED,kDAA0B;AAO1B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;AAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,GAAW,EAAE,OAAe;IACnD,IAAI,QAAQ;QAAE,OAAO;IAErB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa;IAC3B,IAAI,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,QAAQ,GAAG,IAAI,CAAC;IAEhB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,UAAU,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,eAAK,CAAC,MAAM,CAAC,OAAO,UAAU,mCAAmC,CAAC,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/framework/index.d.ts

@@ -8,9 +8,12 @@
  *   - State Store (pub-sub)
  */
 export { buildTool, toOpenAITool, toOpenAITools } from './tool';
+export { serializeToolResult, parseToolResultEnvelope, TOOL_RESULT_SCHEMA_VERSION } from './tool-serializer';
 export type { OpenHorseTool, ToolResult, ToolContext, ToolConfig, PermissionResult, ToolInputJSONSchema, OpenAITool, } from './tool';
 export { query } from './query';
 export type { QueryEvent, QueryParams } from './query';
+export { prepareToolCalls, executeToolCalls, inspectSchedule } from './tool-scheduler';
+export type { PreparedToolCall, ExecutedToolCall, ToolSchedule, ToolSchedulerOptions } from './tool-scheduler';
 export { buildSystemPrompt, getSystemPrompt } from './prompt';
 export type { PromptContext, PromptSection } from './prompt';
 export { Store } from './store';

package/dist/framework/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAChE,YAAY,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACX,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC7G,YAAY,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACX,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE/G,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/framework/index.js

@@ -9,13 +9,21 @@
  *   - State Store (pub-sub)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetToolState = exports.subscribeToolState = exports.setToolState = exports.getToolState = exports.upgradeHarnessState = exports.rankEvidence = exports.classifyIntent = exports.buildHarnessContext = exports.assembleHarnessMessages = exports.renderHarnessStateForCompact = exports.renderContextCapsule = exports.createContextCapsule = exports.ContextLedger = exports.createContextHarness = exports.ContextHarness = exports.Store = exports.getSystemPrompt = exports.buildSystemPrompt = exports.query = exports.toOpenAITools = exports.toOpenAITool = exports.buildTool = void 0;
+exports.resetToolState = exports.subscribeToolState = exports.setToolState = exports.getToolState = exports.upgradeHarnessState = exports.rankEvidence = exports.classifyIntent = exports.buildHarnessContext = exports.assembleHarnessMessages = exports.renderHarnessStateForCompact = exports.renderContextCapsule = exports.createContextCapsule = exports.ContextLedger = exports.createContextHarness = exports.ContextHarness = exports.Store = exports.getSystemPrompt = exports.buildSystemPrompt = exports.inspectSchedule = exports.executeToolCalls = exports.prepareToolCalls = exports.query = exports.TOOL_RESULT_SCHEMA_VERSION = exports.parseToolResultEnvelope = exports.serializeToolResult = exports.toOpenAITools = exports.toOpenAITool = exports.buildTool = void 0;
 var tool_1 = require("./tool");
 Object.defineProperty(exports, "buildTool", { enumerable: true, get: function () { return tool_1.buildTool; } });
 Object.defineProperty(exports, "toOpenAITool", { enumerable: true, get: function () { return tool_1.toOpenAITool; } });
 Object.defineProperty(exports, "toOpenAITools", { enumerable: true, get: function () { return tool_1.toOpenAITools; } });
+var tool_serializer_1 = require("./tool-serializer");
+Object.defineProperty(exports, "serializeToolResult", { enumerable: true, get: function () { return tool_serializer_1.serializeToolResult; } });
+Object.defineProperty(exports, "parseToolResultEnvelope", { enumerable: true, get: function () { return tool_serializer_1.parseToolResultEnvelope; } });
+Object.defineProperty(exports, "TOOL_RESULT_SCHEMA_VERSION", { enumerable: true, get: function () { return tool_serializer_1.TOOL_RESULT_SCHEMA_VERSION; } });
 var query_1 = require("./query");
 Object.defineProperty(exports, "query", { enumerable: true, get: function () { return query_1.query; } });
+var tool_scheduler_1 = require("./tool-scheduler");
+Object.defineProperty(exports, "prepareToolCalls", { enumerable: true, get: function () { return tool_scheduler_1.prepareToolCalls; } });
+Object.defineProperty(exports, "executeToolCalls", { enumerable: true, get: function () { return tool_scheduler_1.executeToolCalls; } });
+Object.defineProperty(exports, "inspectSchedule", { enumerable: true, get: function () { return tool_scheduler_1.inspectSchedule; } });
 var prompt_1 = require("./prompt");
 Object.defineProperty(exports, "buildSystemPrompt", { enumerable: true, get: function () { return prompt_1.buildSystemPrompt; } });
 Object.defineProperty(exports, "getSystemPrompt", { enumerable: true, get: function () { return prompt_1.getSystemPrompt; } });

package/dist/framework/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+BAAgE;AAAvD,iGAAA,SAAS,OAAA;AAAE,oGAAA,YAAY,OAAA;AAAE,qGAAA,aAAa,OAAA;AAW/C,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,mCAA8D;AAArD,2GAAA,iBAAiB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAG3C,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,sCAYoB;AAXlB,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,wGAAA,aAAa,OAAA;AACb,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,uHAAA,4BAA4B,OAAA;AAC5B,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA;AACnB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AAerB,2CAKsB;AAJpB,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAClB,4GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+BAAgE;AAAvD,iGAAA,SAAS,OAAA;AAAE,oGAAA,YAAY,OAAA;AAAE,qGAAA,aAAa,OAAA;AAC/C,qDAA6G;AAApG,sHAAA,mBAAmB,OAAA;AAAE,0HAAA,uBAAuB,OAAA;AAAE,6HAAA,0BAA0B,OAAA;AAWjF,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,mDAAuF;AAA9E,kHAAA,gBAAgB,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAAE,iHAAA,eAAe,OAAA;AAG5D,mCAA8D;AAArD,2GAAA,iBAAiB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAG3C,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,sCAYoB;AAXlB,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,wGAAA,aAAa,OAAA;AACb,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,uHAAA,4BAA4B,OAAA;AAC5B,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA;AACnB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AAerB,2CAKsB;AAJpB,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAClB,4GAAA,cAAc,OAAA"}

package/dist/framework/query.d.ts

@@ -38,6 +38,10 @@ export type QueryEvent = {
     result: string;
     duration: number;
     success: boolean;
+    artifactRef?: {
+        id: string;
+        outputBytes: number;
+    };
     error?: string;
     summary?: string;
     outputBytes?: number;

package/dist/framework/query.d.ts.map

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