@kody-ade/kody-engine 0.4.241 → 0.4.243

package/dist/agent-actions/agent-factory/profile.json

@@ -0,0 +1,47 @@
+{
+  "name": "agent-factory",
+  "action": "agent-factory",
+  "describe": "Create or assemble Kody agency model definitions from an operator request.",
+  "capabilityKind": "act",
+  "role": "primitive",
+  "kind": "oneshot",
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number containing the operator request."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": null,
+    "maxTurnTimeoutSec": 1200,
+    "systemPromptAppend": null,
+    "cacheable": true,
+    "enableVerifyTool": false,
+    "tools": ["Read", "Grep", "Glob"],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      { "script": "loadIssueContext" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseAgentResult" },
+      { "script": "openAgentFactoryStatePr" }
+    ]
+  },
+  "output": {
+    "actionTypes": ["AGENT_FACTORY_COMPLETED", "AGENT_FACTORY_FAILED", "AGENT_NOT_RUN"]
+  }
+}

package/dist/agent-actions/agent-factory/prompt.md

@@ -0,0 +1,62 @@
+You are Kody's agent factory. Convert the operator request into review-ready Kody agency model definitions.
+
+# Target
+
+- Consumer repo: {{repoOwner}}/{{repoName}}
+- Default branch: {{defaultBranch}}
+- Issue #{{issue.number}}: {{issue.title}}
+
+{{agentResponsibilityReference}}
+
+# Operator Request
+
+{{issue.body}}
+
+# Recent comments (most recent first, truncated)
+
+{{issue.commentsFormatted}}
+
+# Task
+
+Design the smallest Kody model structure that satisfies the request. You may create or assemble simple agentActions, agentResponsibilities, loops, goals, and agents.
+
+Use the current Kody vocabulary:
+
+- agent: who runs
+- agentResponsibility: why/when and public action ownership
+- agentAction: how work runs
+- goal: related task list/state
+
+# Boundaries
+
+- Do not edit files directly.
+- Do not run `git`, `gh`, shell commands, or any external command.
+- Do not activate generated definitions yourself.
+- Do not create a consumer-repo PR.
+- The deterministic postflight will open a review PR in the configured state repo under the configured state path.
+- Put generated file paths relative to the consumer repo, usually under `.kody/...`.
+- Produce complete file contents. Do not describe patches.
+- Prefer a small bundle over a broad framework. Include assumptions in the summary.
+
+# Final Output Contract
+
+If the request is too ambiguous to produce review-ready definitions, output one line:
+
+FAILED: <specific missing decision>
+
+Otherwise output exactly:
+
+DONE
+PR_SUMMARY:
+{
+  "title": "short title",
+  "summary": "human explanation and assumptions",
+  "files": [
+    {
+      "path": ".kody/agent-actions/example/profile.json",
+      "content": "{\n  \"name\": \"example\"\n}\n"
+    }
+  ]
+}
+
+The `PR_SUMMARY` value must be valid JSON. Do not wrap it in a markdown code fence.

package/dist/agent-responsibilities/agent-factory/agent-responsibility.md

@@ -0,0 +1,10 @@
+# Agent Factory
+
+## Purpose
+
+Create or assemble Kody agency model definitions from an operator request.
+
+## Instructions
+
+Use the `agent-factory` agentAction for the implementation details.
+The agentResponsibility owns the public action name and review boundary; the agentAction owns model reasoning and state-repo PR creation.

package/dist/agent-responsibilities/agent-factory/profile.json

@@ -0,0 +1,7 @@
+{
+  "name": "agent-factory",
+  "action": "agent-factory",
+  "agentAction": "agent-factory",
+  "capabilityKind": "act",
+  "describe": "Create or assemble Kody agency model definitions from an operator request."
+}

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.241",
+      version: "0.4.243",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative agentAction profiles.",
       license: "MIT",
       type: "module",
@@ -334,9 +334,22 @@ function is404(err) {
 }
 function parseStateRepoSlug(slug, field = "stateRepo") {
   const value = slug.trim();
-  const parts = value.split("/");
+  let repoPath = value;
+  if (/^https?:\/\//i.test(value)) {
+    let parsed;
+    try {
+      parsed = new URL(value);
+    } catch {
+      throw new Error(`kody.config.json: ${field} must be a GitHub repository URL`);
+    }
+    if (parsed.protocol !== "https:" || parsed.hostname !== "github.com") {
+      throw new Error(`kody.config.json: ${field} must be a https://github.com repository URL`);
+    }
+    repoPath = parsed.pathname.replace(/^\/+|\/+$/g, "").replace(/\.git$/i, "");
+  }
+  const parts = repoPath.split("/");
   if (parts.length !== 2 || !parts[0] || !parts[1]) {
-    throw new Error(`kody.config.json: ${field} must look like "owner/repo"`);
+    throw new Error(`kody.config.json: ${field} must be a https://github.com/owner/repo URL`);
   }
   for (const part of parts) {
     if (!/^[A-Za-z0-9_.-]+$/.test(part)) {
@@ -537,7 +550,7 @@ function parseStateConfig(raw, github) {
   const nested = recordValue(raw.state) ?? {};
   const repoRaw = typeof raw.stateRepo === "string" ? raw.stateRepo : nested.repo;
   const pathRaw = typeof raw.statePath === "string" ? raw.statePath : nested.path;
-  const stateRepo = typeof repoRaw === "string" && repoRaw.trim().length > 0 ? repoRaw.trim() : `${String(github.owner)}/kody-state`;
+  const stateRepo = typeof repoRaw === "string" && repoRaw.trim().length > 0 ? repoRaw.trim() : `https://github.com/${String(github.owner)}/kody-state`;
   parseStateRepoSlug(stateRepo);
   const statePath2 = typeof pathRaw === "string" && pathRaw.trim().length > 0 ? pathRaw.trim() : String(github.repo);
   return {
@@ -2393,6 +2406,7 @@ function parseAgentResponsibilityConfig(raw) {
     mentions: stringList(raw.mentions).map((m) => m.replace(/^@/, "")),
     tools,
     agentActions: stringList(raw.agentActions),
+    capabilityKind: capabilityKindField(raw.capabilityKind),
     describe: stringField(raw.describe),
     stage: stringField(raw.stage),
     readsFrom: stringList(raw.readsFrom ?? raw.reads_from),
@@ -2432,6 +2446,10 @@ function stringList(value) {
   }
   return [];
 }
+function capabilityKindField(value) {
+  if (value === "observe" || value === "act" || value === "verify") return value;
+  return void 0;
+}
 var AGENT_RESPONSIBILITY_PROFILE_FILE, AGENT_RESPONSIBILITY_BODY_FILE;
 var init_agent_responsibilityFolders = __esm({
   "src/agent-responsibilityFolders.ts"() {
@@ -2737,6 +2755,7 @@ function listFolderAgentResponsibilityActions(root, source) {
       cliArgs,
       source,
       describe: agentResponsibility.config.describe ?? agentResponsibility.title,
+      capabilityKind: agentResponsibility.config.capabilityKind,
       profilePath: agentResponsibility.profilePath,
       bodyPath: agentResponsibility.bodyPath
     });
@@ -2759,6 +2778,7 @@ function listBuiltinAgentResponsibilityActions(root = getBuiltinAgentResponsibil
       cliArgs: {},
       source: "builtin",
       describe: agentResponsibility.config.describe ?? agentResponsibility.title,
+      capabilityKind: agentResponsibility.config.capabilityKind,
       profilePath: agentResponsibility.profilePath,
       bodyPath: agentResponsibility.bodyPath
     });
@@ -11252,6 +11272,220 @@ var init_notifyTerminal = __esm({
   }
 });
 
+// src/scripts/openAgentFactoryStatePr.ts
+function parseAgentFactoryBundle(raw) {
+  const jsonText = stripJsonFence(raw);
+  let parsed;
+  try {
+    parsed = JSON.parse(jsonText);
+  } catch (err) {
+    throw new Error(`openAgentFactoryStatePr: PR_SUMMARY must be valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("openAgentFactoryStatePr: PR_SUMMARY must be a JSON object");
+  }
+  const value = parsed;
+  const title = readRequiredJsonString(value.title, "title");
+  const summary = readRequiredJsonString(value.summary, "summary");
+  if (!Array.isArray(value.files) || value.files.length === 0) {
+    throw new Error("openAgentFactoryStatePr: files must be a non-empty array");
+  }
+  const files = value.files.map((item, index) => {
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+      throw new Error(`openAgentFactoryStatePr: files[${index}] must be an object`);
+    }
+    const file = item;
+    return {
+      path: readRequiredJsonString(file.path, `files[${index}].path`),
+      content: readJsonString(file.content, `files[${index}].content`)
+    };
+  });
+  return { title, summary, files };
+}
+function buildAgentFactoryBranchName(issueNumber, title, now = Date.now()) {
+  const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48).replace(/-+$/g, "");
+  const suffix = slug ? `-${slug}` : "";
+  return `agent-factory/issue-${issueNumber}-${now.toString(36)}${suffix}`;
+}
+function normalizeBundleFiles(ctx, bundle) {
+  const seen = /* @__PURE__ */ new Set();
+  return bundle.files.map((file, index) => {
+    if (file.path.startsWith("/") || file.path.includes("\\")) {
+      throw new Error(`openAgentFactoryStatePr: files[${index}].path must be a relative POSIX path`);
+    }
+    const relativePath = normalizeStatePath(file.path, `files[${index}].path`);
+    if (seen.has(relativePath)) {
+      throw new Error(`openAgentFactoryStatePr: duplicate generated file path: ${relativePath}`);
+    }
+    seen.add(relativePath);
+    return {
+      ...file,
+      path: relativePath,
+      targetPath: stateRepoPath(ctx.config, relativePath)
+    };
+  });
+}
+function stripJsonFence(raw) {
+  const text = raw.trim();
+  const fence = text.match(/^```(?:json)?\s*\n([\s\S]*?)\n```$/i);
+  return (fence ? fence[1] : text).trim();
+}
+function readIssueNumber(ctx) {
+  const issueNumber = ctx.args.issue;
+  if (typeof issueNumber !== "number" || !Number.isInteger(issueNumber) || issueNumber <= 0) {
+    throw new Error("openAgentFactoryStatePr: ctx.args.issue must be a positive integer");
+  }
+  return issueNumber;
+}
+function readRequiredJsonString(value, field) {
+  const text = readJsonString(value, field).trim();
+  if (!text) throw new Error(`openAgentFactoryStatePr: ${field} must be a non-empty string`);
+  return text;
+}
+function readJsonString(value, field) {
+  if (typeof value !== "string") throw new Error(`openAgentFactoryStatePr: ${field} must be a string`);
+  return value;
+}
+function requireString2(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`openAgentFactoryStatePr: missing ${label}`);
+  }
+  return value;
+}
+function ghJson(args, cwd, input) {
+  const raw = gh(args, input === void 0 ? { cwd } : { cwd, input: JSON.stringify(input) });
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`openAgentFactoryStatePr: gh api returned invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+function renderPullRequestBody(ctx, bundle, files) {
+  const issueNumber = readIssueNumber(ctx);
+  return [
+    "Agent factory generated a Kody agency model bundle for review.",
+    "",
+    `Source issue: ${ctx.config.github.owner}/${ctx.config.github.repo}#${issueNumber}`,
+    "",
+    "## Summary",
+    "",
+    bundle.summary,
+    "",
+    "## Files",
+    "",
+    ...files.map((file) => `- \`${file.targetPath}\``),
+    "",
+    "Generated definitions are inactive until this state-repo PR is reviewed and merged."
+  ].join("\n");
+}
+function renderIssueComment(owner, repo, prUrl, bundle) {
+  return [
+    `agent-factory opened a state-repo review PR: ${prUrl}`,
+    "",
+    `State repo: ${owner}/${repo}`,
+    "",
+    "Summary:",
+    bundle.summary
+  ].join("\n");
+}
+var openAgentFactoryStatePr;
+var init_openAgentFactoryStatePr = __esm({
+  "src/scripts/openAgentFactoryStatePr.ts"() {
+    "use strict";
+    init_issue();
+    init_stateRepo();
+    openAgentFactoryStatePr = async (ctx, _profile, agentResult) => {
+      if (agentResult?.outcome !== "completed") {
+        throw new Error(`openAgentFactoryStatePr: agent did not complete: ${agentResult?.error ?? "unknown failure"}`);
+      }
+      if (ctx.data.agentDone !== true) {
+        throw new Error("openAgentFactoryStatePr: agent did not produce a successful final result");
+      }
+      if (!ctx.config.state?.repo || !ctx.config.state?.path) {
+        throw new Error("openAgentFactoryStatePr: config.state.repo and config.state.path are required");
+      }
+      const issueNumber = readIssueNumber(ctx);
+      const bundle = parseAgentFactoryBundle(String(ctx.data.prSummary ?? ""));
+      const normalizedFiles = normalizeBundleFiles(ctx, bundle);
+      const stateRepo = parseStateRepo(ctx.config);
+      const baseBranch = "main";
+      const branch = buildAgentFactoryBranchName(issueNumber, bundle.title);
+      const baseRef = ghJson(["api", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/ref/heads/${baseBranch}`], ctx.cwd);
+      const baseSha = requireString2(baseRef.object?.sha, `state repo ${stateRepo.owner}/${stateRepo.repo} ${baseBranch} ref sha`);
+      const baseCommit = ghJson(
+        ["api", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/commits/${baseSha}`],
+        ctx.cwd
+      );
+      const baseTreeSha = requireString2(baseCommit.tree?.sha, `state repo ${stateRepo.owner}/${stateRepo.repo} base tree sha`);
+      ghJson(
+        ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/refs`, "--input", "-"],
+        ctx.cwd,
+        {
+          ref: `refs/heads/${branch}`,
+          sha: baseSha
+        }
+      );
+      const tree = ghJson(
+        ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/trees`, "--input", "-"],
+        ctx.cwd,
+        {
+          base_tree: baseTreeSha,
+          tree: normalizedFiles.map((file) => ({
+            path: file.targetPath,
+            mode: "100644",
+            type: "blob",
+            content: file.content
+          }))
+        }
+      );
+      const treeSha = requireString2(tree.sha, "created tree sha");
+      const commit = ghJson(
+        ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/commits`, "--input", "-"],
+        ctx.cwd,
+        {
+          message: `agent-factory: ${bundle.title}`,
+          tree: treeSha,
+          parents: [baseSha]
+        }
+      );
+      const commitSha = requireString2(commit.sha, "created commit sha");
+      ghJson(
+        ["api", "--method", "PATCH", `/repos/${stateRepo.owner}/${stateRepo.repo}/git/refs/heads/${branch}`, "--input", "-"],
+        ctx.cwd,
+        {
+          sha: commitSha,
+          force: false
+        }
+      );
+      const pr = ghJson(
+        ["api", "--method", "POST", `/repos/${stateRepo.owner}/${stateRepo.repo}/pulls`, "--input", "-"],
+        ctx.cwd,
+        {
+          title: `agent-factory: ${bundle.title}`,
+          head: branch,
+          base: baseBranch,
+          body: renderPullRequestBody(ctx, bundle, normalizedFiles)
+        }
+      );
+      const prUrl = requireString2(pr.html_url, "created pull request url");
+      gh(["issue", "comment", String(issueNumber), "--body-file", "-"], {
+        cwd: ctx.cwd,
+        input: renderIssueComment(stateRepo.owner, stateRepo.repo, prUrl, bundle)
+      });
+      ctx.data.agentFactoryStatePr = {
+        repo: `${stateRepo.owner}/${stateRepo.repo}`,
+        branch,
+        base: baseBranch,
+        url: prUrl,
+        number: pr.number,
+        files: normalizedFiles.map((file) => file.targetPath)
+      };
+      ctx.output.prUrl = prUrl;
+    };
+  }
+});
+
 // src/scripts/openQaIssue.ts
 function qaAction2(verdict, payload) {
   const type = verdict === "PASS" ? "QA_PASS" : verdict === "CONCERNS" ? "QA_CONCERNS" : verdict === "FAIL" ? "QA_FAIL" : "QA_COMPLETED";
@@ -14394,6 +14628,7 @@ var init_scripts = __esm({
     init_mergeReleasePr();
     init_mirrorStateToPr();
     init_notifyTerminal();
+    init_openAgentFactoryStatePr();
     init_openQaIssue();
     init_parseAgentResult();
     init_parseIssueStateFromAgentResult();
@@ -14523,6 +14758,7 @@ var init_scripts = __esm({
       recordClassification,
       dispatchClassified,
       notifyTerminal,
+      openAgentFactoryStatePr,
       openQaIssue,
       createQaGoal,
       failOnceTaskJob,
@@ -15406,7 +15642,8 @@ var init_executor = __esm({
     MUTATING_POSTFLIGHTS = /* @__PURE__ */ new Set([
       "commitAndPush",
       "ensurePr",
-      "applyAgentResponsibilityReports"
+      "applyAgentResponsibilityReports",
+      "openAgentFactoryStatePr"
     ]);
     MAX_CHAIN_HOPS = 60;
     DEFAULT_SHELL_TIMEOUT_MS = 3e5;
@@ -16785,6 +17022,18 @@ function unpackAllSecrets(env = process.env) {
   return count;
 }
 async function resolveAuthToken(env = process.env) {
+  const creds = readAppCreds(env);
+  if (creds) {
+    try {
+      const minted = await mintAppInstallationToken(creds);
+      env.GH_TOKEN = minted;
+      process.stdout.write("\u2192 kody: GH_TOKEN minted from GitHub App (KODY_APP_ID/KODY_APP_PRIVATE_KEY)\n");
+      return minted;
+    } catch (err) {
+      process.stdout.write(`\u2192 kody: WARNING GitHub App token mint failed: ${err.message}
+`);
+    }
+  }
   const sources = [
     ["KODY_TOKEN", env.KODY_TOKEN],
     ["GH_TOKEN", env.GH_TOKEN],
@@ -16799,18 +17048,6 @@ async function resolveAuthToken(env = process.env) {
 `);
     return token;
   }
-  const creds = readAppCreds(env);
-  if (creds) {
-    try {
-      const minted = await mintAppInstallationToken(creds);
-      env.GH_TOKEN = minted;
-      process.stdout.write("\u2192 kody: GH_TOKEN minted from GitHub App (KODY_APP_ID/KODY_APP_PRIVATE_KEY)\n");
-      return minted;
-    } catch (err) {
-      process.stdout.write(`\u2192 kody: WARNING GitHub App token mint failed: ${err.message}
-`);
-    }
-  }
   process.stdout.write(
     "\u2192 kody: WARNING no auth token found (KODY_TOKEN/GH_TOKEN/GITHUB_TOKEN/GH_PAT/GitHub App all empty)\n"
   );
@@ -18232,7 +18469,7 @@ async function loadConfigSafe() {
       quality: { typecheck: "", lint: "", format: "", testUnit: "" },
       git: { defaultBranch: "main" },
       github: { owner: "unknown", repo: "unknown" },
-      state: { repo: "unknown/kody-state", path: "unknown" },
+      state: { repo: "https://github.com/unknown/kody-state", path: "unknown" },
       agent: { model: "claude/claude-sonnet-4" }
     };
   }

package/kody.config.schema.json

@@ -53,6 +53,22 @@
         "repo": { "type": "string" }
       }
     },
+    "state": {
+      "type": "object",
+      "description": "External repository and path used for Kody runtime state.",
+      "additionalProperties": false,
+      "properties": {
+        "repo": {
+          "type": "string",
+          "description": "Full GitHub repository URL for Kody runtime state.",
+          "pattern": "^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+(?:\\.git)?$"
+        },
+        "path": {
+          "type": "string",
+          "description": "Folder inside state.repo that belongs to this consumer repo."
+        }
+      }
+    },
     "agent": {
       "type": "object",
       "required": ["model"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.241",
+  "version": "0.4.243",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative agentAction profiles.",
   "license": "MIT",
   "type": "module",