la-machina-engine 0.17.0 → 0.18.0

package/dist/index.cjs

@@ -3986,6 +3986,29 @@ var RunContext = class {
     });
     this.episodes?.logTurn(this.turnCount, "user", text2);
   }
+  /**
+   * Plan 051 — seed a prior chat turn into the run's message stack
+   * before the current task. Writes a normal `user` / `assistant`
+   * transcript entry so resume + inspect + compaction see the same
+   * conversation the model saw, but intentionally:
+   *   - does NOT increment `turnCount` (a turn is a model response
+   *     this run produced, not historical context)
+   *   - does NOT log to `episodes` (avoid cross-run memory noise)
+   *
+   * Caller is responsible for validating role + content shape; this
+   * helper just persists what it's given.
+   */
+  async seedInitialMessage(role, text2) {
+    const content = [{ type: "text", text: text2 }];
+    this.messages.push({ role, content });
+    await this.writeEntry({
+      type: role,
+      uuid: this.nextUuid(),
+      parentUuid: this.lastUuid,
+      ts: this.now(),
+      message: { role, content }
+    });
+  }
   async addAssistantMessage(content) {
     this.messages.push({ role: "assistant", content });
     await this.writeEntry({
@@ -10879,6 +10902,24 @@ function scrubRunOptions(opts) {
   }
   if (opts.compaction !== void 0) out.compaction = opts.compaction;
   if (opts.context !== void 0) out.context = { ...opts.context };
+  if (opts.initialMessages !== void 0 && Array.isArray(opts.initialMessages)) {
+    const roles = [];
+    let totalChars = 0;
+    for (const m of opts.initialMessages) {
+      if (m === null || typeof m !== "object") continue;
+      const role = m.role;
+      const content = m.content;
+      if (role !== "user" && role !== "assistant") continue;
+      if (typeof content !== "string") continue;
+      roles.push(role);
+      totalChars += content.length;
+    }
+    out.initialMessages = {
+      count: roles.length,
+      roles,
+      totalChars
+    };
+  }
   return out;
 }
 function serializeOutputSchema(schema) {
@@ -10954,6 +10995,14 @@ function rebuildMessagesFromEntries(entries) {
   return messages;
 }
 
+// src/engine/types.ts
+init_cjs_shims();
+var INITIAL_MESSAGES_LIMITS = {
+  maxMessages: 100,
+  maxTotalChars: 32e3,
+  maxCharsPerMessage: 8e3
+};
+
 // src/engine/response.ts
 init_cjs_shims();
 function toResponse(result, extra) {
@@ -11456,6 +11505,23 @@ var Engine = class {
     const runTimeout = this.startRunTimeout();
     try {
       await writer.setStatus("running");
+      if (options.initialMessages !== void 0) {
+        const validation = validateInitialMessages(options.initialMessages);
+        if (!validation.ok) {
+          await writer.setStatus("failed");
+          return {
+            runId,
+            status: "failed",
+            data: null,
+            meta: { nodeId: options.nodeId, durationMs: Date.now() - startTime },
+            errors: [{ code: "ERR_INVALID_INITIAL_MESSAGES", message: validation.message }],
+            timestamp: Date.now()
+          };
+        }
+        for (const m of validation.messages) {
+          await ctx.seedInitialMessage(m.role, m.content);
+        }
+      }
       await dispatchHooks(this.config.hooks.preRun, {
         runId,
         nodeId: options.nodeId,
@@ -12962,6 +13028,60 @@ function buildToolRegistry(options) {
   }
   return registry;
 }
+function validateInitialMessages(raw) {
+  if (!Array.isArray(raw)) {
+    return { ok: false, message: "initialMessages must be an array" };
+  }
+  const { maxMessages, maxTotalChars, maxCharsPerMessage } = INITIAL_MESSAGES_LIMITS;
+  if (raw.length > maxMessages) {
+    return {
+      ok: false,
+      message: `initialMessages exceeds max of ${String(maxMessages)} messages (got ${String(raw.length)})`
+    };
+  }
+  const out = [];
+  let totalChars = 0;
+  for (let i = 0; i < raw.length; i++) {
+    const m = raw[i];
+    if (m === null || typeof m !== "object") {
+      return { ok: false, message: `initialMessages[${String(i)}] must be an object` };
+    }
+    if (m.role !== "user" && m.role !== "assistant") {
+      return {
+        ok: false,
+        message: `initialMessages[${String(i)}].role must be 'user' or 'assistant'`
+      };
+    }
+    if (typeof m.content !== "string") {
+      return {
+        ok: false,
+        message: `initialMessages[${String(i)}].content must be a string`
+      };
+    }
+    const trimmed = m.content.trim();
+    if (trimmed.length === 0) {
+      return {
+        ok: false,
+        message: `initialMessages[${String(i)}].content must not be empty`
+      };
+    }
+    if (trimmed.length > maxCharsPerMessage) {
+      return {
+        ok: false,
+        message: `initialMessages[${String(i)}].content exceeds ${String(maxCharsPerMessage)} chars`
+      };
+    }
+    totalChars += trimmed.length;
+    if (totalChars > maxTotalChars) {
+      return {
+        ok: false,
+        message: `initialMessages total content exceeds ${String(maxTotalChars)} chars`
+      };
+    }
+    out.push({ role: m.role, content: trimmed });
+  }
+  return { ok: true, messages: out };
+}
 
 // src/index.ts
 init_contract();