@kody-ade/kody-engine 0.4.467 → 0.4.469

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.467",
+      version: "0.4.469",
       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
@@ -25322,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" };
@@ -25329,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" };
@@ -25590,6 +25561,7 @@ async function runCi(argv) {
   }
   if (parsedRunRequest && "request" in parsedRunRequest) {
   }
+  const explicitLoopRequest = parsedRunRequest && "request" in parsedRunRequest && parsedRunRequest.request.target.type === "loop";
   if (!args.issueNumber && !autoFallback && parsedRunRequest && "request" in parsedRunRequest) {
     const route = routeRunRequest(parsedRunRequest.request);
     if (route.kind === "error") {
@@ -25660,11 +25632,11 @@ async function runCi(argv) {
       cliArgs: directExecution.cliArgs,
       source: "project-folder"
     } : null);
-    const workflowRoute = manualGoalManager || capabilityRoute || !readWorkflowDefinition(config, cwd, forceRunAction) ? void 0 : {
+    const workflowRoute = manualGoalManager || capabilityRoute || explicitLoopRequest || !readWorkflowDefinition(config, cwd, forceRunAction) ? void 0 : {
       workflow: forceRunAction,
       cliArgs: {}
     };
-    const loop = manualGoalManager || capabilityRoute || workflowRoute ? null : readLoopDefinition(cwd, forceRunAction);
+    const loop = manualGoalManager || capabilityRoute || workflowRoute || explicitLoopRequest ? null : readLoopDefinition(cwd, forceRunAction);
     const loopRoute = loop ? loop.target.kind === "workflow" ? { workflow: loop.target.id, cliArgs: loop.input } : { capability: loop.target.id, action: loop.target.id, cliArgs: loop.input } : void 0;
     const scheduledWatchRoute = manualGoalManager || capabilityRoute || workflowRoute || loopRoute ? void 0 : dispatchScheduledWatches({ force: true, cwd }).find(
       (match) => match.action === forceRunAction || match.capability === forceRunAction || match.implementation === forceRunAction
@@ -27541,10 +27513,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"
@@ -28131,16 +28105,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") {
@@ -28155,55 +28121,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");
@@ -28401,16 +28318,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") {
@@ -28429,57 +28338,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";
@@ -28619,7 +28477,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";
@@ -28634,7 +28492,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.467",
+  "version": "0.4.469",
   "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",