@kody-ade/kody-engine 0.4.466 → 0.4.468

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.466",
+      version: "0.4.468",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -54,6 +54,7 @@ var init_package = __esm({
         "@actions/cache": "^6.0.0",
         "@anthropic-ai/claude-agent-sdk": "0.2.119",
         "@kody-ade/agency-domain": "0.5.1",
+        "@kody-ade/engine-contracts": "0.1.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         ajv: "^8.18.0",
         convex: "^1.17.0",
@@ -14053,6 +14054,11 @@ var init_loopDefinitions = __esm({
 
 // src/scripts/dispatchSimpleLoops.ts
 import { randomUUID as randomUUID2 } from "crypto";
+function selectRunnableLoops(loops, now, options) {
+  return loops.filter(
+    (loop) => loop.enabled && loop.trigger.type === "schedule" && (!options.loopId || loop.id === options.loopId) && (options.force || dueSlot(loop, now) !== null)
+  );
+}
 function loopDispatchSlot(loop, now, force, nonce) {
   return force ? `manual:${now.toISOString()}:${nonce}` : dueSlot(loop, now);
 }
@@ -14110,9 +14116,11 @@ var init_dispatchSimpleLoops = __esm({
       if (!tenantId2) throw new Error("Repository identity is required for Loop dispatch");
       const now = /* @__PURE__ */ new Date();
       const force = ctx.data.jobForce === true;
-      const due = listLoopDefinitions(ctx.cwd).filter(
-        (loop) => loop.enabled && loop.trigger.type === "schedule" && (force || dueSlot(loop, now) !== null)
-      );
+      const requestedLoopId = typeof ctx.args.loop === "string" ? ctx.args.loop.trim() : "";
+      const due = selectRunnableLoops(listLoopDefinitions(ctx.cwd), now, {
+        force,
+        ...requestedLoopId ? { loopId: requestedLoopId } : {}
+      });
       process.stdout.write(
         `\u2192 kody: Loop scheduler found ${due.length} runnable Loop(s)${force ? " (manual)" : ""}
 `
@@ -25172,63 +25180,15 @@ init_loopDefinitions();
 init_registry();
 
 // src/run-request.ts
-var RUN_REQUEST_ENV = "KODY_RUN_REQUEST_JSON";
-var INTENTS = /* @__PURE__ */ new Set(["continue", "manage", "run", "tick"]);
-var SOURCES = /* @__PURE__ */ new Set(["dashboard", "github", "schedule"]);
-var TARGET_TYPES = /* @__PURE__ */ new Set(["chat", "goal", "issue", "workflow"]);
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readString(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-function parseTarget(input) {
-  if (!isRecord2(input)) return { error: "runRequest.target must be an object" };
-  const type = readString(input.type);
-  if (!TARGET_TYPES.has(type)) return { error: "runRequest.target.type is invalid" };
-  if (type === "issue") {
-    const id2 = Number(input.id);
-    if (!Number.isInteger(id2) || id2 <= 0) return { error: "runRequest.target.id must be a positive issue number" };
-    return { target: { type, id: id2 } };
-  }
-  const id = readString(input.id);
-  if (!id) return { error: "runRequest.target.id is required" };
-  return { target: { type, id } };
-}
-function parseRunRequest(input) {
-  let body = input;
-  if (typeof input === "string") {
-    const raw = input.trim();
-    if (!raw) return { error: `${RUN_REQUEST_ENV} is empty` };
-    try {
-      body = JSON.parse(raw);
-    } catch {
-      return { error: `${RUN_REQUEST_ENV} must be valid JSON` };
-    }
-  }
-  if (!isRecord2(body)) return { error: "runRequest must be an object" };
-  const parsedTarget = parseTarget(body.target);
-  if ("error" in parsedTarget) return parsedTarget;
-  const intent = readString(body.intent);
-  if (!INTENTS.has(intent)) return { error: "runRequest.intent is invalid" };
-  const source = readString(body.source);
-  if (!SOURCES.has(source)) return { error: "runRequest.source is invalid" };
-  if (body.input !== void 0 && !isRecord2(body.input)) {
-    return { error: "runRequest.input must be an object when provided" };
-  }
-  return {
-    request: {
-      target: parsedTarget.target,
-      intent,
-      source,
-      ...body.input !== void 0 ? { input: body.input } : {}
-    }
-  };
-}
+import {
+  ENGINE_EXECUTION_REQUEST_ENV,
+  parseEngineExecutionRequest
+} from "@kody-ade/engine-contracts";
+var RUN_REQUEST_ENV = ENGINE_EXECUTION_REQUEST_ENV;
 function readRunRequestFromEnv(env = process.env) {
   const raw = env[RUN_REQUEST_ENV];
   if (raw == null || raw.trim() === "") return null;
-  return parseRunRequest(raw);
+  return parseEngineExecutionRequest(raw);
 }
 
 // src/kody-cli.ts
@@ -25306,6 +25266,9 @@ function parseCiArgs(argv) {
   }
   return result;
 }
+function isScheduledActionsWake(env = process.env) {
+  return env.GITHUB_EVENT_NAME === "schedule" || env.GITHUB_ACTIONS === "true" && !env.GITHUB_EVENT_NAME && !env.GITHUB_EVENT_PATH;
+}
 function routeRunRequest(request) {
   const { target, intent } = request;
   if (target.type === "chat" || target.type === "issue") return { kind: "ignore" };
@@ -25319,6 +25282,16 @@ function routeRunRequest(request) {
       cliArgs: { goal: target.id }
     };
   }
+  if (target.type === "loop") {
+    if (intent !== "run" && intent !== "tick") {
+      return { kind: "error", error: `loop target does not support intent '${intent}'` };
+    }
+    return {
+      kind: "action",
+      action: "loop-scheduler",
+      cliArgs: { loop: target.id }
+    };
+  }
   if (target.type === "workflow") {
     if (target.id === "scheduled-fanout") {
       return { kind: "fanout", force: intent === "run" };
@@ -25326,7 +25299,8 @@ function routeRunRequest(request) {
     if (intent !== "run" && intent !== "tick") {
       return { kind: "error", error: `workflow target does not support intent '${intent}'` };
     }
-    const workflowRunId = typeof request.input?.runId === "string" && /^[a-z0-9][a-z0-9_-]{0,79}$/.test(request.input.runId) ? request.input.runId : void 0;
+    const requestedRunId = typeof request.input?.runId === "string" ? request.input.runId : request.requestId;
+    const workflowRunId = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/.test(requestedRunId) ? requestedRunId : void 0;
     return { kind: "action", action: target.id, cliArgs: {}, ...workflowRunId ? { workflowRunId } : {} };
   }
   return { kind: "error", error: "unsupported run request target" };
@@ -25571,6 +25545,7 @@ async function runCi(argv) {
   }
   const autoFallback = !args.issueNumber ? autoDispatch({ config: earlyConfig }) : null;
   const eventName = process.env.GITHUB_EVENT_NAME;
+  const scheduledActionsWake = isScheduledActionsWake();
   const dispatchEventPath = process.env.GITHUB_EVENT_PATH;
   let manualWorkflowDispatch = false;
   let forceRunAction = null;
@@ -25745,7 +25720,7 @@ async function runCi(argv) {
   if (!args.issueNumber && !autoFallback && runRequestFanOut) {
     return runScheduledFanOut(cwd, args, { force: runRequestFanOutForce });
   }
-  if (!args.issueNumber && !autoFallback && (eventName === "schedule" || manualWorkflowDispatch)) {
+  if (!args.issueNumber && !autoFallback && (scheduledActionsWake || manualWorkflowDispatch)) {
     return runScheduledFanOut(cwd, args, { force: manualWorkflowDispatch });
   }
   if (!args.issueNumber && !autoFallback && process.env.GITHUB_EVENT_NAME) {
@@ -27537,10 +27512,12 @@ async function runAgencyLoopTick(deps) {
   for (const repository of repositories) {
     const [owner, repo] = repository.split("/");
     try {
+      const jobId = `sched-${owner}-${repo}-${clock()}`;
       const result = await deps.claim(owner, repo, {
-        jobId: `sched-${owner}-${repo}-${clock()}`,
+        jobId,
         repo: repository,
         runRequest: {
+          requestId: jobId,
           target: { type: "workflow", id: "scheduled-fanout" },
           intent: "tick",
           source: "schedule"
@@ -28127,16 +28104,8 @@ function parseClaimRequest(body) {
   if (!jobId) return { error: "jobId required" };
   const repo = typeof b.repo === "string" ? b.repo.trim() : "";
   if (!/^[^/\s]+\/[^/\s]+$/.test(repo)) return { error: "repo must be 'owner/name'" };
-  const mode = b.mode === "interactive" ? "interactive" : b.mode === "scheduled" ? "scheduled" : "issue";
-  const action = typeof b.action === "string" && b.action.trim() ? b.action.trim() : void 0;
-  const message = typeof b.message === "string" && b.message.trim() ? b.message.trim() : void 0;
-  const runRequest = b.runRequest !== void 0 ? parseRunRequest(b.runRequest) : synthesizeLegacyClaimRequest({
-    mode,
-    issueNumber: b.issueNumber,
-    sessionId: b.sessionId,
-    action,
-    message
-  });
+  if (b.runRequest === void 0) return { error: "runRequest required" };
+  const runRequest = parseEngineExecutionRequest(b.runRequest);
   if ("error" in runRequest) return { error: runRequest.error };
   const req = { jobId, repo, runRequest: runRequest.request };
   if (req.runRequest.target.type === "issue") {
@@ -28151,55 +28120,6 @@ function parseClaimRequest(body) {
   if (typeof b.dashboardUrl === "string" && b.dashboardUrl.trim()) req.dashboardUrl = b.dashboardUrl.trim();
   return { req };
 }
-function synthesizeLegacyClaimRequest(input) {
-  if (input.mode === "issue") {
-    const issueNumber = Number(input.issueNumber);
-    if (!Number.isInteger(issueNumber) || issueNumber <= 0) return { error: "issueNumber required for issue mode" };
-    return {
-      request: {
-        target: { type: "issue", id: issueNumber },
-        intent: "run",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.mode === "interactive") {
-    const sessionId = typeof input.sessionId === "string" ? input.sessionId.trim() : "";
-    if (!sessionId) return { error: "sessionId required for interactive mode" };
-    return {
-      request: {
-        target: { type: "chat", id: sessionId },
-        intent: "continue",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.action === "goal-manager" && input.message) {
-    return {
-      request: {
-        target: { type: "goal", id: input.message },
-        intent: "manage",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.action) {
-    return {
-      request: {
-        target: { type: "workflow", id: input.action },
-        intent: "run",
-        source: "dashboard"
-      }
-    };
-  }
-  return {
-    request: {
-      target: { type: "workflow", id: "scheduled-fanout" },
-      intent: "tick",
-      source: "schedule"
-    }
-  };
-}
 async function poolServe() {
   const masterRaw = process.env.KODY_MASTER_KEY?.trim();
   if (!masterRaw) throw new Error("KODY_MASTER_KEY required for pool-serve");
@@ -28397,16 +28317,8 @@ function parseJob(body) {
   if (!/^[^/\s]+\/[^/\s]+$/.test(repo)) return { error: "repo must be 'owner/name'" };
   const githubToken = typeof b.githubToken === "string" ? b.githubToken.trim() : "";
   if (!githubToken) return { error: "githubToken required" };
-  const action = typeof b.action === "string" && b.action.trim() ? b.action.trim() : void 0;
-  const message = typeof b.message === "string" && b.message.trim() ? b.message.trim() : void 0;
-  const mode = b.mode === "interactive" ? "interactive" : b.mode === "scheduled" ? "scheduled" : "issue";
-  const runRequest = b.runRequest !== void 0 ? parseRunRequest(b.runRequest) : synthesizeLegacyRunRequest({
-    mode,
-    issueNumber: b.issueNumber,
-    sessionId: b.sessionId,
-    action,
-    message
-  });
+  if (b.runRequest === void 0) return { error: "runRequest required" };
+  const runRequest = parseEngineExecutionRequest(b.runRequest);
   if ("error" in runRequest) return { error: runRequest.error };
   const job = { jobId, repo, githubToken, runRequest: runRequest.request };
   if (job.runRequest.target.type === "issue") {
@@ -28425,57 +28337,6 @@ function parseJob(body) {
   }
   return { job };
 }
-function synthesizeLegacyRunRequest(input) {
-  if (input.mode === "issue") {
-    const issueNumber = Number(input.issueNumber);
-    if (!Number.isInteger(issueNumber) || issueNumber <= 0) {
-      return { error: "issueNumber (positive integer) required for issue mode" };
-    }
-    return {
-      request: {
-        target: { type: "issue", id: issueNumber },
-        intent: "run",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.mode === "interactive") {
-    const sessionId = typeof input.sessionId === "string" ? input.sessionId.trim() : "";
-    if (!sessionId) return { error: "sessionId required for interactive mode" };
-    return {
-      request: {
-        target: { type: "chat", id: sessionId },
-        intent: "continue",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.action === "goal-manager" && input.message) {
-    return {
-      request: {
-        target: { type: "goal", id: input.message },
-        intent: "manage",
-        source: "dashboard"
-      }
-    };
-  }
-  if (input.action) {
-    return {
-      request: {
-        target: { type: "workflow", id: input.action },
-        intent: "run",
-        source: "dashboard"
-      }
-    };
-  }
-  return {
-    request: {
-      target: { type: "workflow", id: "scheduled-fanout" },
-      intent: "tick",
-      source: "schedule"
-    }
-  };
-}
 async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
@@ -28615,7 +28476,7 @@ async function runnerServe() {
 init_config();
 init_litellm();
 import { spawn as spawn10 } from "child_process";
-function parseTarget2(positional) {
+function parseTarget(positional) {
   if (!Array.isArray(positional) || positional.length === 0) return "none";
   const first = String(positional[0]).toLowerCase();
   if (first === "vscode" || first === "code") return "vscode";
@@ -28630,7 +28491,7 @@ function buildProxyEnv(url) {
   };
 }
 async function serve(opts) {
-  const target = parseTarget2(opts.args);
+  const target = parseTarget(opts.args);
   const model = parseProviderModel(opts.config.agent.model);
   const usesProxy = needsLitellmProxy(model);
   let handle = null;

package/dist/runtime-services/loop-scheduler/profile.json

@@ -27,6 +27,14 @@
     ],
     "postflight": []
   },
-  "inputs": [],
+  "inputs": [
+    {
+      "name": "loop",
+      "flag": "--loop",
+      "type": "string",
+      "required": false,
+      "description": "Optional Loop id to run without dispatching other Loops."
+    }
+  ],
   "name": "loop-scheduler"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.466",
+  "version": "0.4.468",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,7 @@
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
     "@kody-ade/agency-domain": "0.5.1",
+    "@kody-ade/engine-contracts": "0.1.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.18.0",
     "convex": "^1.17.0",