@cluesmith/codev 3.3.4 → 3.3.6

package/dist/agent-farm/servers/decisions/splice.js

@@ -0,0 +1,120 @@
+// Ruling splice for the decisions file (Spec 1819).
+//
+// A pure function that writes the owner's ruling into the file's text, or refuses
+// with a specific reason and returns no text. The write route is a thin wrapper
+// around it: read the file, splice, write back only on success.
+//
+// The ruling goes directly after the item's `**Your word:**` line: the word on the
+// very next line; then the comment, after a blank line when a word was written; then
+// a blank line when the line that follows is not already blank. Inserted lines use
+// the file's own line ending, a missing final newline on the Your-word line is
+// supplied, and every other character is preserved in order. The result is
+// re-parsed and must keep the file's structure — anything the explicit checks miss
+// (an option word that is itself a heading or fence, say) is `structure-changed`.
+import { isFenceLine, isHeadingLine, isYourWordLine } from './grammar.js';
+import { parseDecisions } from './parse.js';
+/** Longest comment accepted, in characters, after trimming. */
+export const MAX_COMMENT_LENGTH = 10_000;
+function refuse(code, message) {
+    return { ok: false, code, message };
+}
+/** Refuse a comment line that would add structure: a heading, fence or Your-word line. */
+function checkCommentLines(commentLines) {
+    for (const [n, line] of commentLines.entries()) {
+        const where = `Line ${n + 1} of the comment`;
+        if (isHeadingLine(line))
+            return refuse('comment-heading', `${where} is a markdown heading ("${line.trim()}"); headings end the item.`);
+        if (isFenceLine(line))
+            return refuse('comment-fence', `${where} is a code fence ("${line.trim()}"), which would change how the file parses.`);
+        if (isYourWordLine(line))
+            return refuse('comment-your-word', `${where} starts with **Your word:**, which would give the item a second Your-word line.`);
+    }
+    return null;
+}
+/** Find the request's item in `## Open` and check it can take a ruling now. */
+function checkItem(parsed, request, word) {
+    const { id } = request;
+    if (parsed.problems.includes('open-multiple')) {
+        return refuse('open-multiple', 'The file has more than one ## Open section; the tab cannot tell where items belong, so it writes nothing.');
+    }
+    const matches = parsed.items.filter(item => item.id === id);
+    if (matches.length === 0)
+        return refuse('heading-missing', `Item ${id} is not in ## Open (it may have been ruled or removed).`);
+    if (matches.length > 1)
+        return refuse('heading-duplicate', `Item ${id} appears ${matches.length} times in ## Open; rulings for it go through main.`);
+    const item = matches[0];
+    if (item.yourWordLines.length === 0)
+        return refuse('your-word-missing', `Item ${id} has no **Your word:** line to rule under.`);
+    if (item.yourWordLines.length > 1)
+        return refuse('your-word-multiple', `Item ${id} has ${item.yourWordLines.length} **Your word:** lines; the tab cannot tell which one to rule under.`);
+    if (item.currentRuling !== '')
+        return refuse('already-ruled', `Item ${id} already has text under its **Your word:** line; a change goes through main or a hand edit.`);
+    if (word && !item.options.some(option => option.word === word)) {
+        return refuse('unknown-word', `"${word}" is not an option on item ${id}'s current **Your word:** line.`);
+    }
+    if (item.fingerprint !== request.fingerprint)
+        return refuse('item-changed', `Item ${id} changed since it was shown; review it and submit again.`);
+    return item;
+}
+/**
+ * Check the spliced text kept the file's structure: the same sections, the same items
+ * in the same order, the same options on this item, this item's current ruling equal
+ * to the inserted ruling, and every inserted line plain unfenced content.
+ */
+function verify(before, after, item, ruling, insertedLines) {
+    const sections = (p) => p.lines.filter(l => l.headingLevel === 1 || l.headingLevel === 2).map(l => `${l.headingLevel} ${l.headingText}`).join('\n');
+    const changed = (what) => refuse('structure-changed', `Writing this ruling into item ${item.id} would change ${what}, so nothing was written.`);
+    if (sections(after) !== sections(before) || after.problems.join() !== before.problems.join())
+        return changed("the file's sections");
+    if (after.items.map(i => i.id).join('\n') !== before.items.map(i => i.id).join('\n'))
+        return changed('the list of open items');
+    const afterItem = after.items.find(i => i.headingLine === item.headingLine);
+    if (!afterItem || afterItem.id !== item.id)
+        return changed('the list of open items');
+    if (JSON.stringify(afterItem.options) !== JSON.stringify(item.options))
+        return changed("the item's options");
+    if (afterItem.currentRuling !== ruling)
+        return changed("the item's text after its **Your word:** line");
+    const inserted = after.lines.slice(insertedLines.from, insertedLines.from + insertedLines.count);
+    if (inserted.some(l => l.fenced || l.headingLevel > 0 || l.yourWord))
+        return changed("the file's structure (the ruling would add a heading or fence)");
+    return null;
+}
+/** Apply the owner's ruling to the decisions file's text, or refuse with the reason. */
+export function spliceRuling(text, request) {
+    if (!request.id)
+        return refuse('invalid-request', 'The request names no item.');
+    if (!request.fingerprint)
+        return refuse('invalid-request', 'The request carries no item fingerprint.');
+    const word = request.word ?? '';
+    const comment = (request.comment ?? '').trim();
+    if (!word && !comment)
+        return refuse('empty-ruling', 'Choose an option or write a comment.');
+    if (comment.length > MAX_COMMENT_LENGTH) {
+        return refuse('comment-too-long', `The comment is ${comment.length} characters; the limit is ${MAX_COMMENT_LENGTH}.`);
+    }
+    const commentLines = comment ? comment.split(/\r\n|\r|\n/) : [];
+    const commentRefusal = checkCommentLines(commentLines);
+    if (commentRefusal)
+        return commentRefusal;
+    const before = parseDecisions(text);
+    const item = checkItem(before, request, word);
+    if ('ok' in item)
+        return item;
+    const rulingLines = [...(word ? [word] : []), ...(word && comment ? [''] : []), ...commentLines];
+    const yourWord = before.lines[item.yourWordLines[0]];
+    const following = before.lines[yourWord.index + 1];
+    const newLines = following && following.text.trim() !== '' ? [...rulingLines, ''] : rulingLines;
+    const at = yourWord.end + yourWord.eol.length;
+    const inserted = (yourWord.eol === '' ? before.eol : '') + newLines.map(line => line + before.eol).join('');
+    const result = text.slice(0, at) + inserted + text.slice(at);
+    // The parser's current ruling is LF-joined whatever the file's line ending.
+    const refusal = verify(before, parseDecisions(result), item, rulingLines.join('\n'), {
+        from: yourWord.index + 1,
+        count: newLines.length,
+    });
+    if (refusal)
+        return refusal;
+    return { ok: true, text: result };
+}
+//# sourceMappingURL=splice.js.map

package/dist/agent-farm/servers/decisions/splice.js.map

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

package/dist/agent-farm/servers/decisions/stamp.d.ts

@@ -0,0 +1,8 @@
+import type { DecisionStamp } from '@cluesmith/codev-types';
+/**
+ * Resolve a heading stamp to an instant, using the zone written in it or else `fileZone`.
+ * A stamp without a date takes today's date in that zone. Returns null for text that is not
+ * a stamp.
+ */
+export declare function resolveStamp(raw: string, fileZone?: string | null): DecisionStamp | null;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/agent-farm/servers/decisions/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/servers/decisions/stamp.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmI5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,GAAG,IAAI,CAiD9F"}

package/dist/agent-farm/servers/decisions/stamp.js

@@ -0,0 +1,195 @@
+// Decision heading timestamps (Spec 1819, Issue #1836).
+//
+// A stamp is `[YYYY-MM-DD] h:mm am|pm [ZONE]` or `[YYYY-MM-DD] HH:mm [ZONE]`. It is
+// resolved to an absolute instant using the zone written in it or, failing that, the
+// file's `_Zone: …_` line — nothing here defaults to, or special-cases, any zone. A
+// stamp without a date is today in its zone. A stamp with no zone at all is returned
+// unconverted with no reason, so the tab shows it as written; text in none of these
+// forms is not a stamp at all (null).
+//
+// IANA and generic zones are resolved with the runtime's built-in `Intl` time-zone
+// data by offset probing: the wall-clock time is tried against every offset the
+// zone has near that date, and the candidates that round-trip are kept. One means
+// success; none is a spring-forward gap; two is a fall-back fold. Gaps and folds
+// are left unconverted rather than broken by a tie-break rule.
+/** Generic North-American zones: DST follows the stamp's date. */
+const GENERIC_ZONES = {
+    PT: 'America/Los_Angeles',
+    MT: 'America/Denver',
+    CT: 'America/Chicago',
+    ET: 'America/New_York',
+    AKT: 'America/Anchorage',
+    HT: 'Pacific/Honolulu',
+};
+/**
+ * Fixed-offset abbreviations, in minutes east of UTC. `CST` is North-American
+ * Central (China Standard Time is written `+08:00` or `Asia/Shanghai`). Ambiguous
+ * abbreviations (`IST`, `BST`, `AST`, …) are deliberately absent.
+ */
+const FIXED_ZONES = {
+    UTC: 0,
+    GMT: 0,
+    Z: 0,
+    PST: -8 * 60,
+    PDT: -7 * 60,
+    MST: -7 * 60,
+    MDT: -6 * 60,
+    CST: -6 * 60,
+    CDT: -5 * 60,
+    EST: -5 * 60,
+    EDT: -4 * 60,
+    AKST: -9 * 60,
+    AKDT: -8 * 60,
+    HST: -10 * 60,
+    WET: 0,
+    WEST: 1 * 60,
+    CET: 1 * 60,
+    CEST: 2 * 60,
+    EET: 2 * 60,
+    EEST: 3 * 60,
+    MSK: 3 * 60,
+    SGT: 8 * 60,
+    HKT: 8 * 60,
+    JST: 9 * 60,
+    KST: 9 * 60,
+    AEST: 10 * 60,
+    AEDT: 11 * 60,
+    NZST: 12 * 60,
+    NZDT: 13 * 60,
+};
+const STAMP_RE = /^(?:(\d{4})-(\d{2})-(\d{2})\s+)?(\d{1,2}):(\d{2})(?:\s*(am|pm))?(?:\s+(\S+))?$/i;
+const OFFSET_RE = /^(?:UTC|GMT)?([+-])(\d{1,2})(?::?(\d{2}))?$/;
+/** Shaped like a zone (an abbreviation, an Area/Location name, an offset), known or not. */
+const ZONE_LIKE_RE = /^(?:[A-Z]{2,5}|[A-Z][A-Za-z_]*(?:\/[A-Za-z0-9_+-]+)+|(?:UTC|GMT)?[+-]\d{1,2}(?::?\d{2})?)$/;
+const MINUTE_MS = 60_000;
+const DAY_MS = 24 * 60 * MINUTE_MS;
+function isIanaZone(name) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: name });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseZone(zone) {
+    // Own keys only: `in` would let prototype names (`toString`, `__proto__`, …) through.
+    if (Object.hasOwn(FIXED_ZONES, zone))
+        return { kind: 'fixed', offsetMinutes: FIXED_ZONES[zone] };
+    if (Object.hasOwn(GENERIC_ZONES, zone))
+        return { kind: 'iana', name: GENERIC_ZONES[zone] };
+    const offset = OFFSET_RE.exec(zone);
+    if (offset) {
+        const hours = Number(offset[2]);
+        const minutes = offset[3] ? Number(offset[3]) : 0;
+        if (hours > 14 || minutes > 59)
+            return null;
+        const sign = offset[1] === '-' ? -1 : 1;
+        return { kind: 'fixed', offsetMinutes: sign * (hours * 60 + minutes) };
+    }
+    // IANA names only in Area/Location form, so legacy ids (`EST5EDT`, `IST`, …) are
+    // never accepted through the back door.
+    if (zone.includes('/') && isIanaZone(zone))
+        return { kind: 'iana', name: zone };
+    return null;
+}
+const formatters = new Map();
+function formatterFor(zone) {
+    let f = formatters.get(zone);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone: zone,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+        });
+        formatters.set(zone, f);
+    }
+    return f;
+}
+/** The zone's UTC offset, in minutes, at the given instant. */
+function offsetAt(instantMs, zone) {
+    const parts = formatterFor(zone).formatToParts(new Date(instantMs));
+    const get = (type) => Number(parts.find(p => p.type === type).value);
+    const wallMs = Date.UTC(get('year'), get('month') - 1, get('day'), get('hour'), get('minute'));
+    const instantMinute = Math.floor(instantMs / MINUTE_MS) * MINUTE_MS;
+    return Math.round((wallMs - instantMinute) / MINUTE_MS);
+}
+/** All instants whose wall-clock time in `zone` is `wallMs` (as if UTC). */
+function instantsForWallClock(wallMs, zone) {
+    const offsets = new Set([offsetAt(wallMs - DAY_MS, zone), offsetAt(wallMs, zone), offsetAt(wallMs + DAY_MS, zone)]);
+    const instants = new Set();
+    for (const offset of offsets) {
+        const candidate = wallMs - offset * MINUTE_MS;
+        if (offsetAt(candidate, zone) === offset)
+            instants.add(candidate);
+    }
+    return [...instants].sort((a, b) => a - b);
+}
+/** The wall-clock time in `zone` at the given instant, as if UTC. */
+function wallClockAt(instantMs, zone) {
+    const offsetMinutes = zone.kind === 'fixed' ? zone.offsetMinutes : offsetAt(instantMs, zone.name);
+    return instantMs + offsetMinutes * MINUTE_MS;
+}
+/**
+ * Resolve a heading stamp to an instant, using the zone written in it or else `fileZone`.
+ * A stamp without a date takes today's date in that zone. Returns null for text that is not
+ * a stamp.
+ */
+export function resolveStamp(raw, fileZone = null) {
+    const m = STAMP_RE.exec(raw.trim());
+    if (!m)
+        return null;
+    const [, y, mo, d, h, mi, meridiem, zoneText] = m;
+    let hour = Number(h);
+    const minute = Number(mi);
+    if (meridiem) {
+        if (hour < 1 || hour > 12)
+            return null;
+        const pm = meridiem.toLowerCase() === 'pm';
+        hour = (hour % 12) + (pm ? 12 : 0);
+    }
+    else if (hour > 23) {
+        return null;
+    }
+    if (minute > 59)
+        return null;
+    const timeOnly = y === undefined;
+    let dateMs = 0;
+    if (!timeOnly) {
+        const year = Number(y);
+        const month = Number(mo);
+        const day = Number(d);
+        dateMs = Date.UTC(year, month - 1, day);
+        const check = new Date(dateMs);
+        if (check.getUTCFullYear() !== year || check.getUTCMonth() !== month - 1 || check.getUTCDate() !== day)
+            return null;
+    }
+    const stamp = timeOnly ? { raw, instant: null, timeOnly: true } : { raw, instant: null };
+    const zoneName = zoneText ?? fileZone;
+    if (!zoneName)
+        return stamp;
+    const zone = parseZone(zoneName);
+    if (!zone) {
+        // A bare time and a word that is no zone (`10:30 standup?`) is a question, not a stamp.
+        if (timeOnly && zoneText !== undefined && !ZONE_LIKE_RE.test(zoneText))
+            return null;
+        return { ...stamp, unconvertedReason: 'unknown-zone' };
+    }
+    if (timeOnly)
+        dateMs = Math.floor(wallClockAt(Date.now(), zone) / DAY_MS) * DAY_MS;
+    const wallMs = dateMs + (hour * 60 + minute) * MINUTE_MS;
+    if (zone.kind === 'fixed') {
+        return { ...stamp, instant: new Date(wallMs - zone.offsetMinutes * MINUTE_MS).toISOString() };
+    }
+    const instants = instantsForWallClock(wallMs, zone.name);
+    if (instants.length === 0)
+        return { ...stamp, unconvertedReason: 'nonexistent-time' };
+    if (instants.length > 1)
+        return { ...stamp, unconvertedReason: 'ambiguous-time' };
+    return { ...stamp, instant: new Date(instants[0]).toISOString() };
+}
+//# sourceMappingURL=stamp.js.map

package/dist/agent-farm/servers/decisions/stamp.js.map

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

package/dist/agent-farm/servers/decisions/template.d.ts

@@ -0,0 +1,2 @@
+export declare const DECISIONS_FILE_TEMPLATE = "# Pending owner decisions \u2014 all architects (hub: main)\n\nRule inline: one word on the line under an item's **Your word:** line, or in the Decisions tab.\nNewest first. Only main edits this file; architects send items with `afx send architect:main 'DECISION \u2026'`.\n\n_Status: 0 open._\n_Zone: UTC_\n\n## Open\n\n## Ruled\n";
+//# sourceMappingURL=template.d.ts.map

package/dist/agent-farm/servers/decisions/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/servers/decisions/template.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,gVAWnC,CAAC"}

package/dist/agent-farm/servers/decisions/template.js

@@ -0,0 +1,15 @@
+// The decisions file a workspace starts from (Issue #1840). `afx decisions init` writes
+// it; section 4 of resources/decision-protocol.md shows it, and a test pins the two equal.
+export const DECISIONS_FILE_TEMPLATE = `# Pending owner decisions — all architects (hub: main)
+
+Rule inline: one word on the line under an item's **Your word:** line, or in the Decisions tab.
+Newest first. Only main edits this file; architects send items with \`afx send architect:main 'DECISION …'\`.
+
+_Status: 0 open._
+_Zone: UTC_
+
+## Open
+
+## Ruled
+`;
+//# sourceMappingURL=template.js.map

package/dist/agent-farm/servers/decisions/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/agent-farm/servers/decisions/template.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,2FAA2F;AAE3F,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;CAWtC,CAAC"}

package/dist/agent-farm/servers/ide-server.d.ts

@@ -7,10 +7,18 @@
  * Runtime state lives in the `~/.agent-farm/ide-server.json` record (Issue
  * #1668 §D3) — no config file, no `global.db` change. Liveness is discovered by
  * port (`getProcessesOnPort`), the same way Tower finds its own process.
+ *
+ * Every spawn runs a preflight first (Spec 1789): the server version floor and
+ * the embedded sidebar install into the Tower-owned extensions directory. The
+ * preflight throws before anything is stopped, replaced or recorded, so a
+ * refused start leaves a live server and its record untouched. Lifecycle
+ * operations are serialized by `withIdeLock`, taken only at the entry points
+ * (`spawnIdeServer`, `stopIdeServer`, the respawn in `ensureIdeServerLive`);
+ * the unlocked bodies call each other freely, so the nesting cannot deadlock.
  */
 import http from 'node:http';
 import { type IdeServerRecord } from '../lib/ide-record.js';
-type LogFn = (level: 'INFO' | 'ERROR' | 'WARN', message: string) => void;
+import { type LogFn } from '../lib/ide-version.js';
 /**
  * The recorded IDE server port, or null if none — the forward's hot-path target
  * resolution. A plain record read, no port scan (Issue #1668): a dead server
@@ -21,18 +29,31 @@ export declare function getRecordedIdePort(): number | null;
 export interface SpawnIdeOptions {
     serverPath: string;
     port?: number;
-    defaultFolder?: string;
+}
+export interface SpawnIdeResult {
+    record: IdeServerRecord;
+    /**
+     * True when an already-live server was adopted that is not running what
+     * this start asked for: the sidebar just changed, the recorded server path,
+     * sidebar version or extensions directory differs from the current one
+     * (including a legacy record with neither), or its launch arguments are
+     * unknown (no prior record). The live server is never killed; the user
+     * restarts it.
+     */
+    restartRequired: boolean;
 }
 /**
  * Spawn the IDE server detached (so it survives a Tower restart, like a
- * shellper) and write the runtime record. Resolves to the record once the
- * server is listening, or throws if the binary is missing or never binds.
+ * shellper) and write the runtime record. Resolves once the server is
+ * listening, or throws if the binary is missing, fails the preflight, or never
+ * binds. Serialized with every other lifecycle operation.
  */
-export declare function spawnIdeServer(opts: SpawnIdeOptions, log: LogFn): Promise<IdeServerRecord>;
+export declare function spawnIdeServer(opts: SpawnIdeOptions, log: LogFn): Promise<SpawnIdeResult>;
 /**
  * Stop the IDE server on the recorded port: SIGTERM, wait for exit, escalate to
  * SIGKILL for survivors (mirrors `towerStop`, #1668 plan §4), then delete the
- * record. Cold path — `getProcessesOnPort` is fine here.
+ * record. Cold path — `getProcessesOnPort` is fine here. Serialized with every
+ * other lifecycle operation.
  */
 export declare function stopIdeServer(log: LogFn): Promise<{
     stopped: boolean;
@@ -59,10 +80,9 @@ export declare function ensureIdeServerLive(log?: LogFn): Promise<number | null>
 export declare function reconcileIdeServer(log: LogFn): Promise<void>;
 /**
  * Local-only `/api/ide` management endpoint driving the lifecycle above:
- * `POST` starts (body `{ serverPath, port?, defaultFolder? }`), `DELETE` stops,
+ * `POST` starts (body `{ serverPath, port? }`), `DELETE` stops,
  * `GET` reports status. Reached only post-`isRequestAllowed` (key required) and
  * blocked from the tunnel like `/api/tunnel/*` — it spawns/kills a process.
  */
 export declare function handleIdeApi(req: http.IncomingMessage, res: http.ServerResponse, log: LogFn): Promise<void>;
-export {};
 //# sourceMappingURL=ide-server.d.ts.map

package/dist/agent-farm/servers/ide-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ide-server.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/ide-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EAGL,KAAK,eAAe,EAMrB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AA4BzE;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAYD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CA6EhG;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAkClG;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,SAAS,CAK3C;AAKD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,GAAE,KAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBvF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CA6Cf"}
+{"version":3,"file":"ide-server.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/ide-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAGL,KAAK,eAAe,EAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,KAAK,EAGX,MAAM,uBAAuB,CAAC;AA2B/B;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAwBD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;;OAOG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AA4BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAEzF;AAoID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAE5F;AAsCD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,SAAS,CAK3C;AAKD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,GAAE,KAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUvF;AAwBD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CA4Cf"}