farming-code 2.2.29 → 2.2.32

package/backend/session-engine-bridge.cjs

@@ -0,0 +1,144 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_engine_bridge_exports = {};
+__export(session_engine_bridge_exports, {
+  SessionEngineBridge: () => SessionEngineBridge
+});
+module.exports = __toCommonJS(session_engine_bridge_exports);
+var import_events = require("events");
+var import_session_engine_router = require("./session-engine-router.cjs");
+class SessionEngineBridge extends import_events.EventEmitter {
+  router;
+  constructor(configManager) {
+    super();
+    this.router = new import_session_engine_router.SessionEngineRouter(configManager);
+    this.bindEngineEvents();
+  }
+  bindEngineEvents() {
+    Object.entries(this.router.engines).forEach(([engineName, engine]) => {
+      engine.on("session-started", (payload) => {
+        this.emit("session-started", { engineName, ...payload });
+      });
+      engine.on("session-output", (payload) => {
+        this.emit("session-output", { engineName, ...payload });
+      });
+      engine.on("session-transition", (payload) => {
+        this.emit("session-transition", { engineName, ...payload });
+      });
+      engine.on("session-sync", (payload) => {
+        this.emit("session-sync", { engineName, ...payload });
+      });
+      engine.on("session-preview", (payload) => {
+        this.emit("session-preview", { engineName, ...payload });
+      });
+      engine.on("session-title", (payload) => {
+        this.emit("session-title", { engineName, ...payload });
+      });
+      engine.on("session-activity", (payload) => {
+        this.emit("session-activity", { engineName, ...payload });
+      });
+      engine.on("session-busy-state", (payload) => {
+        this.emit("session-busy-state", { engineName, ...payload });
+      });
+      engine.on("session-exited", (payload) => {
+        this.emit("session-exited", { engineName, ...payload });
+      });
+      engine.on("session-error", (payload) => {
+        this.emit("session-error", { engineName, ...payload });
+      });
+    });
+  }
+  resolve(command) {
+    return this.router.resolve(command);
+  }
+  getEngine(name) {
+    return this.router.getEngine(name);
+  }
+  async createSession(command, options) {
+    const resolution = this.resolve(command);
+    await resolution.engine.createSession(options);
+    return resolution;
+  }
+  async sendInput(engineName, sessionId, input, options = {}) {
+    const engine = this.getEngine(engineName);
+    if (!engine) return;
+    return engine.sendInput(sessionId, input, options);
+  }
+  async resizeSession(engineName, sessionId, cols, rows) {
+    const engine = this.getEngine(engineName);
+    if (!engine || !engine.resizeSession) return;
+    return engine.resizeSession(sessionId, cols, rows);
+  }
+  async clearBuffer(engineName, sessionId, options = {}) {
+    const engine = this.getEngine(engineName);
+    if (!engine || !engine.clearBuffer) return;
+    return engine.clearBuffer(sessionId, options);
+  }
+  async killSession(engineName, sessionId) {
+    const engine = this.getEngine(engineName);
+    if (!engine) return;
+    return engine.killSession(sessionId);
+  }
+  async getSessionState(engineName, sessionId) {
+    const engine = this.getEngine(engineName);
+    if (!engine) return null;
+    return engine.getSessionState(sessionId);
+  }
+  async getSessionAttachCheckpoint(engineName, sessionId) {
+    const engine = this.getEngine(engineName);
+    if (!engine || !engine.getSessionAttachCheckpoint) return null;
+    return engine.getSessionAttachCheckpoint(sessionId);
+  }
+  async getSessionPreview(engineName, sessionId) {
+    const engine = this.getEngine(engineName);
+    if (!engine) return "";
+    return engine.getSessionPreview(sessionId);
+  }
+  async recoverSessions(options = {}) {
+    const recovered = [];
+    for (const [engineName, engine] of Object.entries(this.router.engines)) {
+      if (!engine || typeof engine.recoverSessions !== "function") continue;
+      const sessions = await engine.recoverSessions(options);
+      for (const session of sessions) {
+        recovered.push({
+          ...session,
+          engineName
+        });
+      }
+    }
+    return recovered;
+  }
+  consumeRuntimeRotations() {
+    const rotations = [];
+    for (const [engineName, engine] of Object.entries(this.router.engines)) {
+      if (!engine || typeof engine.consumeRuntimeRotation !== "function") continue;
+      const rotation = engine.consumeRuntimeRotation();
+      if (rotation) rotations.push({ engineName, ...rotation });
+    }
+    return rotations;
+  }
+  dispose(options = {}) {
+    return this.router.dispose(options);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionEngineBridge
+});

package/backend/session-engine-router.cjs

@@ -0,0 +1,105 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_engine_router_exports = {};
+__export(session_engine_router_exports, {
+  SessionEngineRouter: () => SessionEngineRouter
+});
+module.exports = __toCommonJS(session_engine_router_exports);
+var import_cli_agents = require("./cli-agents.cjs");
+var import_local_session_engine = require("./local-session-engine.cjs");
+var import_native_session_engine = require("./native-session-engine.cjs");
+class SessionEngineRouter {
+  engines;
+  overrideEngineName;
+  defaultEngineName;
+  constructor(configManager, options = {}) {
+    const configDir = configManager?.farmingDir || void 0;
+    const preserveNativeHost = options.preserveNativeHost !== void 0 ? options.preserveNativeHost === true : process.env.FARMING_NATIVE_PTY_HOST_PERSIST !== "0";
+    this.engines = {
+      native: checkedSessionEngine(
+        new import_native_session_engine.NativeSessionEngine({ configDir, preserveHostOnDispose: preserveNativeHost }),
+        "native"
+      ),
+      local: checkedSessionEngine(new import_local_session_engine.LocalSessionEngine({ configDir }), "local")
+    };
+    this.overrideEngineName = process.env.FARMING_SESSION_ENGINE || "";
+    this.defaultEngineName = options.defaultEngineName || this.overrideEngineName || "native";
+  }
+  getEngine(name) {
+    if (typeof name !== "string") return null;
+    return this.engines[name] || null;
+  }
+  resolve(command) {
+    const spec = (0, import_cli_agents.getAgentSpec)(command);
+    if (!spec) {
+      const engineName2 = this.engines[this.defaultEngineName] ? this.defaultEngineName : this.engines.native ? "native" : "local";
+      return {
+        engine: this.engines[engineName2],
+        engineName: engineName2,
+        spec: null
+      };
+    }
+    if (!spec.supported) {
+      throw new Error(`${spec.name} is not supported in Farming yet`);
+    }
+    const engineName = this.overrideEngineName || spec.preferredEngine || this.defaultEngineName;
+    const engine = this.getEngine(engineName);
+    if (!engine) {
+      throw new Error(`No session engine available for ${spec.name}`);
+    }
+    return {
+      engine,
+      engineName,
+      spec
+    };
+  }
+  dispose(options = {}) {
+    const disposals = Object.values(this.engines).map((engine) => {
+      if (engine && typeof engine.dispose === "function") {
+        return engine.dispose(options);
+      }
+      return void 0;
+    });
+    return Promise.allSettled(disposals);
+  }
+}
+function isSessionEngineContract(engine) {
+  if (!engine || typeof engine !== "object") return false;
+  const candidate = engine;
+  return [
+    "createSession",
+    "dispose",
+    "getSessionPreview",
+    "getSessionState",
+    "killSession",
+    "on",
+    "sendInput"
+  ].every((method) => typeof candidate[method] === "function");
+}
+function checkedSessionEngine(engine, engineName) {
+  if (!isSessionEngineContract(engine)) {
+    throw new Error(`Invalid ${engineName} session engine`);
+  }
+  return engine;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionEngineRouter
+});

package/backend/session-engine.cjs

@@ -0,0 +1,64 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_engine_exports = {};
+__export(session_engine_exports, {
+  SessionEngine: () => SessionEngine
+});
+module.exports = __toCommonJS(session_engine_exports);
+var import_events = require("events");
+class SessionEngine extends import_events.EventEmitter {
+  async createSession(_options) {
+    throw new Error("createSession() must be implemented by subclasses");
+  }
+  async sendInput(_sessionId, _input, _options = {}) {
+    throw new Error("sendInput() must be implemented by subclasses");
+  }
+  async interruptSession(_sessionId, _input, _options = {}) {
+    throw new Error("interruptSession() must be implemented by subclasses");
+  }
+  async resizeSession(_sessionId, _cols, _rows) {
+    throw new Error("resizeSession() must be implemented by subclasses");
+  }
+  async clearBuffer(_sessionId, _options = {}) {
+    throw new Error("clearBuffer() must be implemented by subclasses");
+  }
+  async killSession(_sessionId) {
+    throw new Error("killSession() must be implemented by subclasses");
+  }
+  async getSessionState(_sessionId) {
+    throw new Error("getSessionState() must be implemented by subclasses");
+  }
+  async getSessionPreview(_sessionId) {
+    throw new Error("getSessionPreview() must be implemented by subclasses");
+  }
+  async recoverSessions(_options = {}) {
+    return [];
+  }
+  consumeRuntimeRotation() {
+    return null;
+  }
+  dispose(_options = {}) {
+    return void 0;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionEngine
+});

package/backend/session-stream-protocol.cjs

@@ -0,0 +1,181 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_stream_protocol_exports = {};
+__export(session_stream_protocol_exports, {
+  coalesceSessionStream: () => coalesceSessionStream,
+  deliverSessionStreamToClients: () => deliverSessionStreamToClients,
+  normalizeSessionStream: () => normalizeSessionStream,
+  shouldBroadcastSessionStreamImmediately: () => shouldBroadcastSessionStreamImmediately
+});
+module.exports = __toCommonJS(session_stream_protocol_exports);
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value ? value : void 0;
+}
+function transitionKind(value) {
+  return value === "resize" || value === "clear" ? value : "output";
+}
+function transitionChunks(stream, data, runtimeEpoch, outputSeq, stateRevision) {
+  if (Array.isArray(stream.chunks)) {
+    return stream.chunks.map((value) => {
+      const chunk = value && typeof value === "object" ? value : {};
+      return {
+        kind: transitionKind(chunk.kind),
+        data: typeof chunk.data === "string" ? chunk.data : String(chunk.data || ""),
+        runtimeEpoch: nonEmptyString(chunk.runtimeEpoch),
+        outputSeq: finiteNumber(chunk.outputSeq),
+        stateRevision: finiteNumber(chunk.stateRevision),
+        cols: finiteNumber(chunk.cols),
+        rows: finiteNumber(chunk.rows)
+      };
+    });
+  }
+  if (stream.replace === true || !runtimeEpoch || outputSeq === void 0 || stateRevision === void 0) {
+    return void 0;
+  }
+  return [{
+    kind: transitionKind(stream.kind),
+    data,
+    runtimeEpoch,
+    outputSeq,
+    stateRevision,
+    cols: finiteNumber(stream.cols),
+    rows: finiteNumber(stream.rows)
+  }];
+}
+function normalizeSessionStream(stream) {
+  const data = typeof stream.data === "string" ? stream.data : String(stream.data || "");
+  const runtimeEpoch = nonEmptyString(stream.runtimeEpoch);
+  const outputSeq = finiteNumber(stream.outputSeq);
+  const stateRevision = finiteNumber(stream.stateRevision);
+  return {
+    ...stream,
+    kind: transitionKind(stream.kind),
+    data,
+    replace: stream.replace === true,
+    runtimeEpoch,
+    outputSeq,
+    stateRevision,
+    cols: finiteNumber(stream.cols),
+    rows: finiteNumber(stream.rows),
+    chunks: transitionChunks(stream, data, runtimeEpoch, outputSeq, stateRevision)
+  };
+}
+function coalesceSessionStream(existingStream, incomingStream) {
+  const incoming = normalizeSessionStream(incomingStream);
+  if (!existingStream) {
+    return incoming;
+  }
+  const existing = normalizeSessionStream(existingStream);
+  if (incoming.replace) {
+    if (!existing.runtimeEpoch || !incoming.runtimeEpoch || existing.runtimeEpoch !== incoming.runtimeEpoch) {
+      return incoming;
+    }
+    const existingRevision = finiteNumber(existing.stateRevision);
+    const incomingRevision = finiteNumber(incoming.stateRevision);
+    if (existing.replace && existingRevision !== void 0 && incomingRevision !== void 0 && existingRevision > incomingRevision) {
+      return existing;
+    }
+    if (incomingRevision === void 0) return incoming;
+    const uncoveredChunks = (existing.chunks || []).filter((chunk) => chunk.runtimeEpoch === incoming.runtimeEpoch && chunk.stateRevision !== void 0 && chunk.stateRevision > incomingRevision);
+    return {
+      ...incoming,
+      chunks: uncoveredChunks.length > 0 ? uncoveredChunks : void 0
+    };
+  }
+  if (!existing.runtimeEpoch || !incoming.runtimeEpoch || existing.runtimeEpoch !== incoming.runtimeEpoch) {
+    return incoming;
+  }
+  const incomingHasProof = incoming.outputSeq !== void 0 && incoming.stateRevision !== void 0;
+  if (!incomingHasProof) {
+    return incoming;
+  }
+  if (existing.replace) {
+    return {
+      ...existing,
+      data: existing.data,
+      replace: true,
+      cols: existing.cols,
+      rows: existing.rows,
+      chunks: [
+        ...existing.chunks || [],
+        ...incoming.chunks || []
+      ]
+    };
+  }
+  return {
+    ...existing,
+    ...incoming,
+    data: `${existing.data}${incoming.data}`,
+    replace: false,
+    runtimeEpoch: incoming.runtimeEpoch,
+    outputSeq: incoming.outputSeq,
+    stateRevision: incoming.stateRevision,
+    cols: incoming.cols ?? existing.cols,
+    rows: incoming.rows ?? existing.rows,
+    chunks: [
+      ...existing.chunks || [],
+      ...incoming.chunks || []
+    ]
+  };
+}
+function shouldBroadcastSessionStreamImmediately(options = {}) {
+  const pendingCount = finiteNumber(options.pendingCount) ?? 0;
+  const lastBroadcastAt = finiteNumber(options.lastBroadcastAt) ?? 0;
+  const now = finiteNumber(options.now) ?? Date.now();
+  const intervalMs = Math.max(0, finiteNumber(options.intervalMs) ?? 0);
+  return pendingCount === 0 && (lastBroadcastAt === 0 || now - lastBroadcastAt >= intervalMs);
+}
+function deliverSessionStreamToClients(clients, stream, options = {}) {
+  const openState = options.openState ?? 1;
+  const maxBufferedAmount = finiteNumber(options.maxBufferedAmount) ?? 4 * 1024 * 1024;
+  const message = options.message || JSON.stringify({
+    type: "session-output",
+    stream
+  });
+  const result = { sent: 0, closed: 0, skipped: 0 };
+  for (const client of clients || []) {
+    if (!client || client.readyState !== openState) {
+      result.skipped += 1;
+      continue;
+    }
+    if (client.streamScope === "focused" && client.focusedAgentId !== stream.agentId) {
+      result.skipped += 1;
+      continue;
+    }
+    if (client.bufferedAmount > maxBufferedAmount) {
+      client.close(1013, "terminal stream backpressure");
+      result.closed += 1;
+      continue;
+    }
+    client.send(message);
+    result.sent += 1;
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  coalesceSessionStream,
+  deliverSessionStreamToClients,
+  normalizeSessionStream,
+  shouldBroadcastSessionStreamImmediately
+});