@relay-harness/coding-agent 0.0.0-stage → 1.0.2

package/dist/extensions/laya/questions.js

@@ -0,0 +1,189 @@
+/**
+ * Typed questions Laya answers about each request, in one classifier call.
+ *
+ * Stage A (task intelligence) describes the task. Stage B (execution intelligence) recommends how
+ * to run it. The questions use abstract tiers and efforts, never model names: the model registry
+ * maps tiers to concrete models, so models can change without retraining Laya. The provider is not
+ * a question: it depends on credentials and quota, which only the harness knows.
+ *
+ * These definitions are the contract with the trained checkpoint. `layaDecisionsFile()` exports
+ * them in the laya-trainer format; train and serve with the same wording.
+ */
+export const TASK_TYPES = [
+    "question",
+    "code_edit",
+    "bug_fix",
+    "refactor",
+    "feature",
+    "test",
+    "architecture",
+    "debugging",
+    "security",
+    "research",
+    "documentation",
+];
+export const TASK_SCOPES = [
+    "single_line",
+    "single_file",
+    "module",
+    "multi_module",
+    "repository",
+    "multi_repository",
+];
+export const CAPABILITY_TIERS = ["fast", "balanced", "strong", "frontier"];
+export const REASONING_EFFORTS = ["minimal", "low", "medium", "high", "extra_high"];
+export const VALIDATION_LEVELS = ["none", "syntax", "compile", "unit_test", "integration_test", "review"];
+export const AGENTS = {
+    "software-engineer": "general implementation tasks that fit no specialist below",
+    "backend-engineer": "APIs, services, business rules, queues, server-side code",
+    "frontend-engineer": "web UI, components, styling, browser behavior, accessibility",
+    "mobile-engineer": "iOS, Android, React Native or Flutter apps",
+    "devops-engineer": "CI/CD, builds, containers, infrastructure, deployment, release scripts",
+    "database-engineer": "schemas, migrations, queries, indexes, data modeling",
+    "security-engineer": "vulnerabilities, authentication, authorization, secrets, hardening",
+    "software-architect": "system design, module boundaries, cross-cutting architectural decisions",
+    "qa-engineer": "writing or fixing tests, test strategy, flaky tests, coverage",
+    researcher: "investigating, comparing options or explaining code without changing it",
+};
+export const AGENT_IDS = Object.keys(AGENTS);
+/** Tool needs, asked as independent yes/no questions to avoid a combinatorial choice. */
+export const TOOL_REQUIREMENTS = {
+    requires_write: "Does the task require creating or editing files?",
+    requires_shell: "Does the task require running shell commands other than tests?",
+    requires_tests: "Does the task require running tests, type checks, or builds?",
+    requires_web: "Does the task require searching or reading the web?",
+    requires_browser: "Does the task require driving a browser or checking a running UI?",
+    requires_database: "Does the task require querying or changing a database?",
+    requires_git: "Does the task require git operations such as commits, branches, or history?",
+};
+export const TOOL_REQUIREMENT_IDS = Object.keys(TOOL_REQUIREMENTS);
+export const COMPLEXITY_LEVELS = ["trivial", "simple", "moderate", "complex", "expert"];
+export const RISK_LEVELS = [
+    "low: easy to undo, no user impact",
+    "moderate: visible behavior change",
+    "high: data, money, availability or many users affected",
+    "critical: production data, security or irreversible operations",
+];
+export const AMBIGUITY_LEVELS = [
+    "clear: the request states what to do",
+    "partial: some details must be inferred",
+    "open: the goal or approach must be clarified or explored first",
+];
+export const REASONING_LEVELS = [
+    "recall: answer is direct knowledge",
+    "routine: a known recipe",
+    "multi-step: several dependent steps",
+    "deep: careful analysis of interactions",
+    "novel: design or debugging without a known recipe",
+];
+const yesNo = (instructions, yes, no) => ({
+    type: "bool",
+    instructions,
+    criteria: { true: yes, false: no },
+});
+export const LAYA_QUESTIONS = {
+    task_type: {
+        type: "choice",
+        instructions: "What kind of software engineering task does the request ask for?",
+        criteria: {
+            question: "a question to answer, no change requested",
+            code_edit: "a small, explicit change: rename, text, config value, formatting",
+            bug_fix: "fix behavior that is wrong and reproducible",
+            refactor: "restructure code without changing behavior",
+            feature: "add new behavior or capability",
+            test: "write, fix or extend tests",
+            architecture: "design or evaluate structure across modules or systems",
+            debugging: "investigate a failure whose cause is unknown",
+            security: "find or fix a vulnerability, or change auth, secrets or permissions",
+            research: "explore, compare options or explain code without changing it",
+            documentation: "write or update docs, comments, READMEs or changelogs",
+        },
+    },
+    complexity: {
+        type: "score",
+        instructions: "How complex is the task?",
+        criteria: COMPLEXITY_LEVELS,
+    },
+    scope: {
+        type: "choice",
+        instructions: "How much of the codebase does the task touch?",
+        criteria: {
+            single_line: "one line or one value",
+            single_file: "one file",
+            module: "several files of one module or package",
+            multi_module: "several modules or packages",
+            repository: "the whole repository",
+            multi_repository: "more than one repository or service",
+        },
+    },
+    risk: {
+        type: "score",
+        instructions: "How risky is a wrong result?",
+        criteria: RISK_LEVELS,
+    },
+    ambiguity: {
+        type: "score",
+        instructions: "How ambiguous is the request?",
+        criteria: AMBIGUITY_LEVELS,
+    },
+    reasoning_requirement: {
+        type: "score",
+        instructions: "How much reasoning does the task need?",
+        criteria: REASONING_LEVELS,
+    },
+    capability_tier: {
+        type: "choice",
+        instructions: "What is the cheapest model capability tier likely to solve the task correctly?",
+        criteria: {
+            fast: "small, fast model: trivial edits, lookups, simple questions",
+            balanced: "mid-size model: ordinary features, fixes and refactors",
+            strong: "large model: subtle bugs, risky or cross-module changes",
+            frontier: "most capable model: novel design, hard debugging, critical systems",
+        },
+    },
+    reasoning_effort: {
+        type: "choice",
+        instructions: "How much reasoning effort should the model spend?",
+        criteria: {
+            minimal: "answer or edit directly",
+            low: "brief planning",
+            medium: "plan the steps before acting",
+            high: "analyze alternatives and edge cases",
+            extra_high: "exhaustive analysis of a hard problem",
+        },
+    },
+    agent: {
+        type: "choice",
+        instructions: "Which specialist should handle the task?",
+        criteria: AGENTS,
+    },
+    validation_level: {
+        type: "choice",
+        instructions: "What validation should confirm the result?",
+        criteria: {
+            none: "nothing to validate: answers, explanations, plans",
+            syntax: "check formatting or syntax only: docs, config, text",
+            compile: "type check or build",
+            unit_test: "run unit tests of the changed code",
+            integration_test: "run integration or end-to-end tests",
+            review: "careful review of the change: security, architecture, data",
+        },
+    },
+    ...Object.fromEntries(Object.entries(TOOL_REQUIREMENTS).map(([id, instructions]) => [
+        id,
+        yesNo(instructions, "yes, the task needs it", "no, the task does not need it"),
+    ])),
+    security_sensitive: yesNo("Does the task touch authentication, authorization, secrets, payments, security vulnerabilities, or production data migrations?", "yes, it touches one of these", "no"),
+};
+/** The questions in laya-trainer's `.laya/decisions.json` format (`bool` is `noul` there). */
+export function layaDecisionsFile() {
+    return {
+        description: "Relay adaptive execution intelligence: task profile, capability tier, effort, agent, tools and validation for a coding request.",
+        language: "auto",
+        decisions: Object.fromEntries(Object.entries(LAYA_QUESTIONS).map(([id, question]) => [
+            id,
+            question.type === "bool" ? { ...question, type: "noul" } : question,
+        ])),
+    };
+}
+//# sourceMappingURL=questions.js.map

package/dist/extensions/laya/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../../../src/extensions/laya/questions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ClassifierQuestion } from \"@relay-harness/ai\";\n\n/**\n * Typed questions Laya answers about each request, in one classifier call.\n *\n * Stage A (task intelligence) describes the task. Stage B (execution intelligence) recommends how\n * to run it. The questions use abstract tiers and efforts, never model names: the model registry\n * maps tiers to concrete models, so models can change without retraining Laya. The provider is not\n * a question: it depends on credentials and quota, which only the harness knows.\n *\n * These definitions are the contract with the trained checkpoint. `layaDecisionsFile()` exports\n * them in the laya-trainer format; train and serve with the same wording.\n */\n\nexport const TASK_TYPES = [\n\t\"question\",\n\t\"code_edit\",\n\t\"bug_fix\",\n\t\"refactor\",\n\t\"feature\",\n\t\"test\",\n\t\"architecture\",\n\t\"debugging\",\n\t\"security\",\n\t\"research\",\n\t\"documentation\",\n] as const;\nexport type TaskType = (typeof TASK_TYPES)[number];\n\nexport const TASK_SCOPES = [\n\t\"single_line\",\n\t\"single_file\",\n\t\"module\",\n\t\"multi_module\",\n\t\"repository\",\n\t\"multi_repository\",\n] as const;\nexport type TaskScope = (typeof TASK_SCOPES)[number];\n\nexport const CAPABILITY_TIERS = [\"fast\", \"balanced\", \"strong\", \"frontier\"] as const;\nexport type CapabilityTier = (typeof CAPABILITY_TIERS)[number];\n\nexport const REASONING_EFFORTS = [\"minimal\", \"low\", \"medium\", \"high\", \"extra_high\"] as const;\nexport type ReasoningEffort = (typeof REASONING_EFFORTS)[number];\n\nexport const VALIDATION_LEVELS = [\"none\", \"syntax\", \"compile\", \"unit_test\", \"integration_test\", \"review\"] as const;\nexport type ValidationLevel = (typeof VALIDATION_LEVELS)[number];\n\nexport const AGENTS = {\n\t\"software-engineer\": \"general implementation tasks that fit no specialist below\",\n\t\"backend-engineer\": \"APIs, services, business rules, queues, server-side code\",\n\t\"frontend-engineer\": \"web UI, components, styling, browser behavior, accessibility\",\n\t\"mobile-engineer\": \"iOS, Android, React Native or Flutter apps\",\n\t\"devops-engineer\": \"CI/CD, builds, containers, infrastructure, deployment, release scripts\",\n\t\"database-engineer\": \"schemas, migrations, queries, indexes, data modeling\",\n\t\"security-engineer\": \"vulnerabilities, authentication, authorization, secrets, hardening\",\n\t\"software-architect\": \"system design, module boundaries, cross-cutting architectural decisions\",\n\t\"qa-engineer\": \"writing or fixing tests, test strategy, flaky tests, coverage\",\n\tresearcher: \"investigating, comparing options or explaining code without changing it\",\n} as const satisfies Record<string, string>;\nexport type AgentId = keyof typeof AGENTS;\nexport const AGENT_IDS = Object.keys(AGENTS) as AgentId[];\n\n/** Tool needs, asked as independent yes/no questions to avoid a combinatorial choice. */\nexport const TOOL_REQUIREMENTS = {\n\trequires_write: \"Does the task require creating or editing files?\",\n\trequires_shell: \"Does the task require running shell commands other than tests?\",\n\trequires_tests: \"Does the task require running tests, type checks, or builds?\",\n\trequires_web: \"Does the task require searching or reading the web?\",\n\trequires_browser: \"Does the task require driving a browser or checking a running UI?\",\n\trequires_database: \"Does the task require querying or changing a database?\",\n\trequires_git: \"Does the task require git operations such as commits, branches, or history?\",\n} as const;\nexport type ToolRequirement = keyof typeof TOOL_REQUIREMENTS;\nexport const TOOL_REQUIREMENT_IDS = Object.keys(TOOL_REQUIREMENTS) as ToolRequirement[];\n\nexport const COMPLEXITY_LEVELS = [\"trivial\", \"simple\", \"moderate\", \"complex\", \"expert\"];\nexport const RISK_LEVELS = [\n\t\"low: easy to undo, no user impact\",\n\t\"moderate: visible behavior change\",\n\t\"high: data, money, availability or many users affected\",\n\t\"critical: production data, security or irreversible operations\",\n];\nexport const AMBIGUITY_LEVELS = [\n\t\"clear: the request states what to do\",\n\t\"partial: some details must be inferred\",\n\t\"open: the goal or approach must be clarified or explored first\",\n];\nexport const REASONING_LEVELS = [\n\t\"recall: answer is direct knowledge\",\n\t\"routine: a known recipe\",\n\t\"multi-step: several dependent steps\",\n\t\"deep: careful analysis of interactions\",\n\t\"novel: design or debugging without a known recipe\",\n];\n\nconst yesNo = (instructions: string, yes: string, no: string): ClassifierQuestion => ({\n\ttype: \"bool\",\n\tinstructions,\n\tcriteria: { true: yes, false: no },\n});\n\nexport const LAYA_QUESTIONS: Record<string, ClassifierQuestion> = {\n\ttask_type: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"What kind of software engineering task does the request ask for?\",\n\t\tcriteria: {\n\t\t\tquestion: \"a question to answer, no change requested\",\n\t\t\tcode_edit: \"a small, explicit change: rename, text, config value, formatting\",\n\t\t\tbug_fix: \"fix behavior that is wrong and reproducible\",\n\t\t\trefactor: \"restructure code without changing behavior\",\n\t\t\tfeature: \"add new behavior or capability\",\n\t\t\ttest: \"write, fix or extend tests\",\n\t\t\tarchitecture: \"design or evaluate structure across modules or systems\",\n\t\t\tdebugging: \"investigate a failure whose cause is unknown\",\n\t\t\tsecurity: \"find or fix a vulnerability, or change auth, secrets or permissions\",\n\t\t\tresearch: \"explore, compare options or explain code without changing it\",\n\t\t\tdocumentation: \"write or update docs, comments, READMEs or changelogs\",\n\t\t},\n\t},\n\tcomplexity: {\n\t\ttype: \"score\",\n\t\tinstructions: \"How complex is the task?\",\n\t\tcriteria: COMPLEXITY_LEVELS,\n\t},\n\tscope: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"How much of the codebase does the task touch?\",\n\t\tcriteria: {\n\t\t\tsingle_line: \"one line or one value\",\n\t\t\tsingle_file: \"one file\",\n\t\t\tmodule: \"several files of one module or package\",\n\t\t\tmulti_module: \"several modules or packages\",\n\t\t\trepository: \"the whole repository\",\n\t\t\tmulti_repository: \"more than one repository or service\",\n\t\t},\n\t},\n\trisk: {\n\t\ttype: \"score\",\n\t\tinstructions: \"How risky is a wrong result?\",\n\t\tcriteria: RISK_LEVELS,\n\t},\n\tambiguity: {\n\t\ttype: \"score\",\n\t\tinstructions: \"How ambiguous is the request?\",\n\t\tcriteria: AMBIGUITY_LEVELS,\n\t},\n\treasoning_requirement: {\n\t\ttype: \"score\",\n\t\tinstructions: \"How much reasoning does the task need?\",\n\t\tcriteria: REASONING_LEVELS,\n\t},\n\tcapability_tier: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"What is the cheapest model capability tier likely to solve the task correctly?\",\n\t\tcriteria: {\n\t\t\tfast: \"small, fast model: trivial edits, lookups, simple questions\",\n\t\t\tbalanced: \"mid-size model: ordinary features, fixes and refactors\",\n\t\t\tstrong: \"large model: subtle bugs, risky or cross-module changes\",\n\t\t\tfrontier: \"most capable model: novel design, hard debugging, critical systems\",\n\t\t},\n\t},\n\treasoning_effort: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"How much reasoning effort should the model spend?\",\n\t\tcriteria: {\n\t\t\tminimal: \"answer or edit directly\",\n\t\t\tlow: \"brief planning\",\n\t\t\tmedium: \"plan the steps before acting\",\n\t\t\thigh: \"analyze alternatives and edge cases\",\n\t\t\textra_high: \"exhaustive analysis of a hard problem\",\n\t\t},\n\t},\n\tagent: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"Which specialist should handle the task?\",\n\t\tcriteria: AGENTS,\n\t},\n\tvalidation_level: {\n\t\ttype: \"choice\",\n\t\tinstructions: \"What validation should confirm the result?\",\n\t\tcriteria: {\n\t\t\tnone: \"nothing to validate: answers, explanations, plans\",\n\t\t\tsyntax: \"check formatting or syntax only: docs, config, text\",\n\t\t\tcompile: \"type check or build\",\n\t\t\tunit_test: \"run unit tests of the changed code\",\n\t\t\tintegration_test: \"run integration or end-to-end tests\",\n\t\t\treview: \"careful review of the change: security, architecture, data\",\n\t\t},\n\t},\n\t...Object.fromEntries(\n\t\tObject.entries(TOOL_REQUIREMENTS).map(([id, instructions]) => [\n\t\t\tid,\n\t\t\tyesNo(instructions, \"yes, the task needs it\", \"no, the task does not need it\"),\n\t\t]),\n\t),\n\tsecurity_sensitive: yesNo(\n\t\t\"Does the task touch authentication, authorization, secrets, payments, security vulnerabilities, or production data migrations?\",\n\t\t\"yes, it touches one of these\",\n\t\t\"no\",\n\t),\n};\n\n/** The questions in laya-trainer's `.laya/decisions.json` format (`bool` is `noul` there). */\nexport function layaDecisionsFile(): {\n\tdescription: string;\n\tlanguage: string;\n\tdecisions: Record<string, unknown>;\n} {\n\treturn {\n\t\tdescription:\n\t\t\t\"Relay adaptive execution intelligence: task profile, capability tier, effort, agent, tools and validation for a coding request.\",\n\t\tlanguage: \"auto\",\n\t\tdecisions: Object.fromEntries(\n\t\t\tObject.entries(LAYA_QUESTIONS).map(([id, question]) => [\n\t\t\t\tid,\n\t\t\t\tquestion.type === \"bool\" ? { ...question, type: \"noul\" } : question,\n\t\t\t]),\n\t\t),\n\t};\n}\n"]}

package/dist/extensions/laya/routers.d.ts

@@ -0,0 +1,17 @@
+import type { TaskAssessment } from "./assessment.ts";
+import type { PolicyDecision } from "./policy.ts";
+import { type AgentId, type ToolRequirement } from "./questions.ts";
+export interface SkillInfo {
+    name: string;
+    description: string;
+}
+/** Up to `limit` skills whose name or description matches the agent's keyword family or the request. */
+export declare function selectSkills(skills: readonly SkillInfo[], agent: AgentId, request: string, limit?: number): string[];
+/**
+ * Tools to deactivate for this task: tools that match only requirements the task does not have.
+ * `bash` serves shell, tests and git, so it stays when any of them is needed.
+ */
+export declare function unneededTools(activeTools: readonly string[], tools: Record<ToolRequirement, boolean>): string[];
+/** The advisory plan sent to the model next to the user's message. */
+export declare function renderPlanMessage(assessment: TaskAssessment, policy: PolicyDecision, skills: readonly string[], enforcedTools: readonly string[]): string;
+//# sourceMappingURL=routers.d.ts.map

package/dist/extensions/laya/routers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routers.d.ts","sourceRoot":"","sources":["../../../src/extensions/laya/routers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAU,KAAK,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,gBAAgB,CAAC;AA2ClG,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAe/G;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAK/G;AAqBD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC9B,MAAM,CA0BR"}

package/dist/extensions/laya/routers.js

@@ -0,0 +1,119 @@
+import { AGENTS } from "./questions.js";
+/**
+ * Agent, skill and tool routing. Relay has no agent registry, so the agent is a role the plan
+ * message asks the model to take. Skills are reduced hierarchically: the agent picks a keyword
+ * family, and only skills matching it are named. Tools are advised by default; with
+ * `laya.toolRouting: "enforce"` the tools a task clearly does not need are deactivated.
+ */
+const AGENT_SKILL_KEYWORDS = {
+    "software-engineer": [
+        "code",
+        "implement",
+        "refactor",
+        "typescript",
+        "javascript",
+        "python",
+        "java",
+        "golang",
+        "rust",
+    ],
+    "backend-engineer": ["api", "backend", "server", "service", "rest", "graphql", "queue", "spring", "node"],
+    "frontend-engineer": [
+        "frontend",
+        "ui",
+        "ux",
+        "css",
+        "react",
+        "vue",
+        "angular",
+        "component",
+        "accessibility",
+        "design",
+    ],
+    "mobile-engineer": ["mobile", "android", "ios", "swift", "kotlin", "flutter", "react-native"],
+    "devops-engineer": ["devops", "ci", "deploy", "docker", "kubernetes", "infra", "terraform", "release"],
+    "database-engineer": ["database", "sql", "postgres", "mysql", "migration", "schema", "query", "cockroach"],
+    "security-engineer": ["security", "auth", "oauth", "vulnerab", "secret", "crypto", "audit", "compliance"],
+    "software-architect": ["architecture", "system-design", "design", "ddd", "distributed", "event", "adr"],
+    "qa-engineer": ["test", "qa", "testing", "coverage", "e2e", "playwright", "vitest", "jest"],
+    researcher: ["research", "explain", "analysis", "docs", "compare", "documentation"],
+};
+/** Up to `limit` skills whose name or description matches the agent's keyword family or the request. */
+export function selectSkills(skills, agent, request, limit = 3) {
+    const keywords = AGENT_SKILL_KEYWORDS[agent];
+    const requestWords = new Set(request.toLowerCase().match(/[a-z0-9-]{4,}/g) ?? []);
+    return skills
+        .map((skill) => {
+        const name = skill.name.toLowerCase();
+        const text = `${name} ${skill.description.toLowerCase()}`;
+        const keywordHits = keywords.filter((keyword) => text.includes(keyword)).length;
+        const requestHits = name.split(/[^a-z0-9]+/).filter((part) => requestWords.has(part)).length;
+        return { name: skill.name, score: keywordHits + 2 * requestHits };
+    })
+        .filter((skill) => skill.score > 0)
+        .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name))
+        .slice(0, limit)
+        .map((skill) => skill.name);
+}
+/** Tool name patterns per requirement. Tools matching none of them are never deactivated. */
+const TOOL_PATTERNS = {
+    requires_write: /^(edit|write|multi_?edit|apply_patch)$/,
+    requires_shell: /^bash$/,
+    requires_tests: /^bash$/,
+    requires_git: /^bash$/,
+    requires_web: /web|fetch|search_web|http/,
+    requires_browser: /browser|playwright|puppeteer/,
+    requires_database: /sql|database|\bdb\b|postgres|mysql/,
+};
+/**
+ * Tools to deactivate for this task: tools that match only requirements the task does not have.
+ * `bash` serves shell, tests and git, so it stays when any of them is needed.
+ */
+export function unneededTools(activeTools, tools) {
+    return activeTools.filter((name) => {
+        const matched = Object.keys(TOOL_PATTERNS).filter((id) => TOOL_PATTERNS[id].test(name));
+        return matched.length > 0 && matched.every((id) => !tools[id]);
+    });
+}
+const VALIDATION_HINTS = {
+    none: "no check needed",
+    syntax: "check formatting or syntax of what changed",
+    compile: "run the type check or build",
+    unit_test: "run the unit tests that cover the change",
+    integration_test: "run the integration or end-to-end tests of the affected flow",
+    review: "review the change for security, data and architectural impact, then run the relevant tests",
+};
+const TOOL_LABELS = {
+    requires_write: "file edits",
+    requires_shell: "shell",
+    requires_tests: "tests",
+    requires_web: "web",
+    requires_browser: "browser",
+    requires_database: "database",
+    requires_git: "git",
+};
+/** The advisory plan sent to the model next to the user's message. */
+export function renderPlanMessage(assessment, policy, skills, enforcedTools) {
+    const percent = (value) => `${Math.round(value * 100)}%`;
+    const needed = Object.keys(TOOL_LABELS).filter((id) => assessment.tools[id]);
+    const notNeeded = Object.keys(TOOL_LABELS).filter((id) => !assessment.tools[id]);
+    const lines = [
+        "[laya:plan] Execution plan from the harness router for this request (guidance, not a constraint):",
+        `- Task: ${assessment.task.type.replaceAll("_", " ")}, scope ${assessment.task.scope.replaceAll("_", " ")}, complexity ${percent(assessment.task.complexity)}, risk ${percent(assessment.task.risk)}.`,
+        `- Role: act as ${assessment.agent} (${AGENTS[assessment.agent]}).`,
+    ];
+    if (skills.length > 0)
+        lines.push(`- Skills likely relevant: ${skills.join(", ")}. Load one only when a step needs it.`);
+    lines.push(`- Tools: ${needed.length > 0 ? `needs ${needed.map((id) => TOOL_LABELS[id]).join(", ")}` : "read-only"}${notNeeded.length > 0 ? `; not expected: ${notNeeded.map((id) => TOOL_LABELS[id]).join(", ")}` : ""}.`);
+    if (enforcedTools.length > 0)
+        lines.push(`- Deactivated for this request: ${enforcedTools.join(", ")}.`);
+    if (policy.validation.level !== "none") {
+        lines.push(`- Validation${policy.validation.required ? " (required)" : ""}: ${VALIDATION_HINTS[policy.validation.level]} before reporting completion.`);
+    }
+    if (policy.rules.length > 0)
+        lines.push(`- Sensitive area: ${policy.rules.join(", ")}. Prefer the safest correct change.`);
+    if (assessment.task.ambiguity >= 0.75)
+        lines.push("- The request is open: confirm the goal before large changes.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=routers.js.map

package/dist/extensions/laya/routers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routers.js","sourceRoot":"","sources":["../../../src/extensions/laya/routers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TaskAssessment } from \"./assessment.ts\";\nimport type { PolicyDecision } from \"./policy.ts\";\nimport { AGENTS, type AgentId, type ToolRequirement, type ValidationLevel } from \"./questions.ts\";\n\n/**\n * Agent, skill and tool routing. Relay has no agent registry, so the agent is a role the plan\n * message asks the model to take. Skills are reduced hierarchically: the agent picks a keyword\n * family, and only skills matching it are named. Tools are advised by default; with\n * `laya.toolRouting: \"enforce\"` the tools a task clearly does not need are deactivated.\n */\n\nconst AGENT_SKILL_KEYWORDS: Record<AgentId, string[]> = {\n\t\"software-engineer\": [\n\t\t\"code\",\n\t\t\"implement\",\n\t\t\"refactor\",\n\t\t\"typescript\",\n\t\t\"javascript\",\n\t\t\"python\",\n\t\t\"java\",\n\t\t\"golang\",\n\t\t\"rust\",\n\t],\n\t\"backend-engineer\": [\"api\", \"backend\", \"server\", \"service\", \"rest\", \"graphql\", \"queue\", \"spring\", \"node\"],\n\t\"frontend-engineer\": [\n\t\t\"frontend\",\n\t\t\"ui\",\n\t\t\"ux\",\n\t\t\"css\",\n\t\t\"react\",\n\t\t\"vue\",\n\t\t\"angular\",\n\t\t\"component\",\n\t\t\"accessibility\",\n\t\t\"design\",\n\t],\n\t\"mobile-engineer\": [\"mobile\", \"android\", \"ios\", \"swift\", \"kotlin\", \"flutter\", \"react-native\"],\n\t\"devops-engineer\": [\"devops\", \"ci\", \"deploy\", \"docker\", \"kubernetes\", \"infra\", \"terraform\", \"release\"],\n\t\"database-engineer\": [\"database\", \"sql\", \"postgres\", \"mysql\", \"migration\", \"schema\", \"query\", \"cockroach\"],\n\t\"security-engineer\": [\"security\", \"auth\", \"oauth\", \"vulnerab\", \"secret\", \"crypto\", \"audit\", \"compliance\"],\n\t\"software-architect\": [\"architecture\", \"system-design\", \"design\", \"ddd\", \"distributed\", \"event\", \"adr\"],\n\t\"qa-engineer\": [\"test\", \"qa\", \"testing\", \"coverage\", \"e2e\", \"playwright\", \"vitest\", \"jest\"],\n\tresearcher: [\"research\", \"explain\", \"analysis\", \"docs\", \"compare\", \"documentation\"],\n};\n\nexport interface SkillInfo {\n\tname: string;\n\tdescription: string;\n}\n\n/** Up to `limit` skills whose name or description matches the agent's keyword family or the request. */\nexport function selectSkills(skills: readonly SkillInfo[], agent: AgentId, request: string, limit = 3): string[] {\n\tconst keywords = AGENT_SKILL_KEYWORDS[agent];\n\tconst requestWords = new Set(request.toLowerCase().match(/[a-z0-9-]{4,}/g) ?? []);\n\treturn skills\n\t\t.map((skill) => {\n\t\t\tconst name = skill.name.toLowerCase();\n\t\t\tconst text = `${name} ${skill.description.toLowerCase()}`;\n\t\t\tconst keywordHits = keywords.filter((keyword) => text.includes(keyword)).length;\n\t\t\tconst requestHits = name.split(/[^a-z0-9]+/).filter((part) => requestWords.has(part)).length;\n\t\t\treturn { name: skill.name, score: keywordHits + 2 * requestHits };\n\t\t})\n\t\t.filter((skill) => skill.score > 0)\n\t\t.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name))\n\t\t.slice(0, limit)\n\t\t.map((skill) => skill.name);\n}\n\n/** Tool name patterns per requirement. Tools matching none of them are never deactivated. */\nconst TOOL_PATTERNS: Record<ToolRequirement, RegExp> = {\n\trequires_write: /^(edit|write|multi_?edit|apply_patch)$/,\n\trequires_shell: /^bash$/,\n\trequires_tests: /^bash$/,\n\trequires_git: /^bash$/,\n\trequires_web: /web|fetch|search_web|http/,\n\trequires_browser: /browser|playwright|puppeteer/,\n\trequires_database: /sql|database|\\bdb\\b|postgres|mysql/,\n};\n\n/**\n * Tools to deactivate for this task: tools that match only requirements the task does not have.\n * `bash` serves shell, tests and git, so it stays when any of them is needed.\n */\nexport function unneededTools(activeTools: readonly string[], tools: Record<ToolRequirement, boolean>): string[] {\n\treturn activeTools.filter((name) => {\n\t\tconst matched = (Object.keys(TOOL_PATTERNS) as ToolRequirement[]).filter((id) => TOOL_PATTERNS[id].test(name));\n\t\treturn matched.length > 0 && matched.every((id) => !tools[id]);\n\t});\n}\n\nconst VALIDATION_HINTS: Record<ValidationLevel, string> = {\n\tnone: \"no check needed\",\n\tsyntax: \"check formatting or syntax of what changed\",\n\tcompile: \"run the type check or build\",\n\tunit_test: \"run the unit tests that cover the change\",\n\tintegration_test: \"run the integration or end-to-end tests of the affected flow\",\n\treview: \"review the change for security, data and architectural impact, then run the relevant tests\",\n};\n\nconst TOOL_LABELS: Record<ToolRequirement, string> = {\n\trequires_write: \"file edits\",\n\trequires_shell: \"shell\",\n\trequires_tests: \"tests\",\n\trequires_web: \"web\",\n\trequires_browser: \"browser\",\n\trequires_database: \"database\",\n\trequires_git: \"git\",\n};\n\n/** The advisory plan sent to the model next to the user's message. */\nexport function renderPlanMessage(\n\tassessment: TaskAssessment,\n\tpolicy: PolicyDecision,\n\tskills: readonly string[],\n\tenforcedTools: readonly string[],\n): string {\n\tconst percent = (value: number) => `${Math.round(value * 100)}%`;\n\tconst needed = (Object.keys(TOOL_LABELS) as ToolRequirement[]).filter((id) => assessment.tools[id]);\n\tconst notNeeded = (Object.keys(TOOL_LABELS) as ToolRequirement[]).filter((id) => !assessment.tools[id]);\n\tconst lines = [\n\t\t\"[laya:plan] Execution plan from the harness router for this request (guidance, not a constraint):\",\n\t\t`- Task: ${assessment.task.type.replaceAll(\"_\", \" \")}, scope ${assessment.task.scope.replaceAll(\"_\", \" \")}, complexity ${percent(assessment.task.complexity)}, risk ${percent(assessment.task.risk)}.`,\n\t\t`- Role: act as ${assessment.agent} (${AGENTS[assessment.agent]}).`,\n\t];\n\tif (skills.length > 0)\n\t\tlines.push(`- Skills likely relevant: ${skills.join(\", \")}. Load one only when a step needs it.`);\n\tlines.push(\n\t\t`- Tools: ${needed.length > 0 ? `needs ${needed.map((id) => TOOL_LABELS[id]).join(\", \")}` : \"read-only\"}${\n\t\t\tnotNeeded.length > 0 ? `; not expected: ${notNeeded.map((id) => TOOL_LABELS[id]).join(\", \")}` : \"\"\n\t\t}.`,\n\t);\n\tif (enforcedTools.length > 0) lines.push(`- Deactivated for this request: ${enforcedTools.join(\", \")}.`);\n\tif (policy.validation.level !== \"none\") {\n\t\tlines.push(\n\t\t\t`- Validation${policy.validation.required ? \" (required)\" : \"\"}: ${VALIDATION_HINTS[policy.validation.level]} before reporting completion.`,\n\t\t);\n\t}\n\tif (policy.rules.length > 0)\n\t\tlines.push(`- Sensitive area: ${policy.rules.join(\", \")}. Prefer the safest correct change.`);\n\tif (assessment.task.ambiguity >= 0.75) lines.push(\"- The request is open: confirm the goal before large changes.\");\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/extensions/laya/runtime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Local Laya runtime: the trained model, a Python environment with the `laya` package, and the
+ * script that serves them. The npm package carries none of these (the model is 650 MB, the
+ * environment a few GB); `setupLayaRuntime()` fetches them on first use into the agent directory.
+ */
+export interface LayaModelFile {
+    /** Path inside the model directory, with forward slashes. */
+    path: string;
+    /** Flat file name of the release asset. */
+    asset: string;
+    size: number;
+    sha256: string;
+}
+export interface LayaModelManifest {
+    version: string;
+    /** pip requirement for the Laya runtime. */
+    layaPackage: string;
+    /** Directory URL the assets are downloaded from, ending in a slash. */
+    baseUrl: string;
+    files: LayaModelFile[];
+}
+export type ExecFunction = (command: string, args: string[], options?: {
+    signal?: AbortSignal;
+    timeout?: number;
+}) => Promise<{
+    stdout: string;
+    stderr: string;
+    code: number;
+}>;
+export interface LayaPaths {
+    home: string;
+    model: string;
+    venv: string;
+    venvPython: string;
+    serveScript: string;
+    log: string;
+}
+export declare function layaPaths(home: string, manifest: LayaModelManifest): LayaPaths;
+export type LayaRuntimeStatus = "ready" | "missing-environment" | "missing-model";
+/** Files of the model that are absent or have the wrong size. A full hash check happens at download. */
+export declare function missingModelFiles(manifest: LayaModelManifest, paths: LayaPaths): LayaModelFile[];
+export declare function runtimeStatus(manifest: LayaModelManifest, paths: LayaPaths): LayaRuntimeStatus;
+export interface DownloadOptions {
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+    onProgress?: (file: LayaModelFile, received: number) => void;
+}
+/**
+ * Downloads the files that are missing or wrong, verifying each against its manifest hash before it
+ * becomes visible: a download is written to a `.part` file and renamed only when the hash matches.
+ */
+export declare function downloadModel(manifest: LayaModelManifest, paths: LayaPaths, options?: DownloadOptions): Promise<void>;
+/** A Python 3.10 to 3.13 interpreter (the range torch publishes wheels for), as command plus leading args. */
+export declare function findPython(exec: ExecFunction, override?: string): Promise<[string, string[]] | undefined>;
+export interface SetupOptions {
+    exec: ExecFunction;
+    home: string;
+    manifest: LayaModelManifest;
+    python?: string;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+    report: (message: string) => void;
+}
+/** Creates the environment, installs torch and Laya, writes the server script and downloads the model. */
+export declare function setupLayaRuntime(options: SetupOptions): Promise<LayaPaths>;
+/** Serves the model with the System One protocol Relay's `typesafe-system-one` classifier speaks. */
+export declare const SERVE_SCRIPT = "import argparse\n\nimport laya\nimport torch\nimport uvicorn\nfrom fastapi import FastAPI, HTTPException\n\nparser = argparse.ArgumentParser()\nparser.add_argument(\"--model\", required=True)\nparser.add_argument(\"--host\", default=\"127.0.0.1\")\nparser.add_argument(\"--port\", type=int, default=8000)\nargs = parser.parse_args()\n\nagent = laya.load(args.model, device=\"cuda\" if torch.cuda.is_available() else \"cpu\")\napp = FastAPI(title=\"relay-laya\")\n\n\n@app.get(\"/health\")\ndef health():\n    return {\"ok\": True, \"model\": args.model}\n\n\n@app.post(\"/v1/systemone\")\ndef system_one(body: dict):\n    if \"state\" not in body or not body.get(\"questions\"):\n        raise HTTPException(422, \"send 'state' and 'questions'\")\n    return agent.predict(body[\"state\"], body[\"questions\"])\n\n\nuvicorn.run(app, host=args.host, port=args.port, log_level=\"warning\")\n";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/extensions/laya/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/extensions/laya/runtime.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAChD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/D,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAc9E;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAElF,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,GAAG,aAAa,EAAE,CAShG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAG9F;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAQD,8GAA8G;AAC9G,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAgB/G;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AA6BD,0GAA0G;AAC1G,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAqDhF;AAED,qGAAqG;AACrG,eAAO,MAAM,YAAY,83BA8BxB,CAAC"}

package/dist/extensions/laya/runtime.js

@@ -0,0 +1,179 @@
+import { createHash } from "node:crypto";
+import { createWriteStream, existsSync, mkdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+export function layaPaths(home, manifest) {
+    const venv = join(home, "venv");
+    return {
+        home,
+        model: join(home, "models", manifest.version),
+        venv,
+        venvPython: join(venv, process.platform === "win32" ? "Scripts" : "bin", process.platform === "win32" ? "python.exe" : "python"),
+        serveScript: join(home, "serve.py"),
+        log: join(home, "server.log"),
+    };
+}
+/** Files of the model that are absent or have the wrong size. A full hash check happens at download. */
+export function missingModelFiles(manifest, paths) {
+    return manifest.files.filter((file) => {
+        const path = join(paths.model, ...file.path.split("/"));
+        try {
+            return statSync(path).size !== file.size;
+        }
+        catch {
+            return true;
+        }
+    });
+}
+export function runtimeStatus(manifest, paths) {
+    if (!existsSync(paths.venvPython) || !existsSync(paths.serveScript))
+        return "missing-environment";
+    return missingModelFiles(manifest, paths).length > 0 ? "missing-model" : "ready";
+}
+/**
+ * Downloads the files that are missing or wrong, verifying each against its manifest hash before it
+ * becomes visible: a download is written to a `.part` file and renamed only when the hash matches.
+ */
+export async function downloadModel(manifest, paths, options = {}) {
+    const request = options.fetch ?? globalThis.fetch;
+    for (const file of missingModelFiles(manifest, paths)) {
+        const target = join(paths.model, ...file.path.split("/"));
+        const partial = `${target}.part`;
+        mkdirSync(dirname(target), { recursive: true });
+        const response = await request(new URL(file.asset, manifest.baseUrl), { signal: options.signal });
+        if (!response.ok || !response.body) {
+            throw new Error(`Downloading ${file.asset} failed: HTTP ${response.status}`);
+        }
+        const hash = createHash("sha256");
+        let received = 0;
+        const meter = new Transform({
+            transform(chunk, _encoding, callback) {
+                hash.update(chunk);
+                received += chunk.length;
+                options.onProgress?.(file, received);
+                callback(null, chunk);
+            },
+        });
+        try {
+            await pipeline(Readable.fromWeb(response.body), meter, createWriteStream(partial), { signal: options.signal });
+            const digest = hash.digest("hex");
+            if (received !== file.size || digest !== file.sha256) {
+                throw new Error(`${file.asset} does not match the manifest (size ${received}, sha256 ${digest})`);
+            }
+            renameSync(partial, target);
+        }
+        catch (error) {
+            rmSync(partial, { force: true });
+            throw error;
+        }
+    }
+}
+const PYTHON_CANDIDATES = [
+    ["python3", []],
+    ["python", []],
+    ["py", ["-3"]],
+];
+/** A Python 3.10 to 3.13 interpreter (the range torch publishes wheels for), as command plus leading args. */
+export async function findPython(exec, override) {
+    const candidates = override ? [[override, []]] : PYTHON_CANDIDATES;
+    for (const [command, leading] of candidates) {
+        try {
+            const result = await exec(command, [...leading, "-c", "import sys; print(sys.version_info[0], sys.version_info[1])"], { timeout: 15_000 });
+            const [major, minor] = result.stdout.trim().split(" ").map(Number);
+            if (result.code === 0 && major === 3 && minor >= 10 && minor <= 13)
+                return [command, leading];
+        }
+        catch {
+            // Not installed.
+        }
+    }
+    return undefined;
+}
+const PIP_TIMEOUT_MS = 30 * 60_000;
+async function run(exec, command, args, options, failure) {
+    const result = await exec(command, args, options);
+    if (result.code !== 0) {
+        throw new Error(`${failure}: ${(result.stderr || result.stdout).trim().split("\n").slice(-4).join(" ")}`);
+    }
+}
+/** Torch wheel index: a CUDA build only where an NVIDIA GPU exists, the small CPU build otherwise. */
+async function torchArgs(exec) {
+    if (process.platform === "darwin")
+        return ["torch"];
+    let gpu = false;
+    try {
+        gpu = (await exec("nvidia-smi", ["-L"], { timeout: 10_000 })).code === 0;
+    }
+    catch {
+        // No NVIDIA driver.
+    }
+    return ["torch", "--index-url", `https://download.pytorch.org/whl/${gpu ? "cu128" : "cpu"}`];
+}
+/** Creates the environment, installs torch and Laya, writes the server script and downloads the model. */
+export async function setupLayaRuntime(options) {
+    const { exec, report, signal } = options;
+    const paths = layaPaths(options.home, options.manifest);
+    mkdirSync(paths.home, { recursive: true });
+    const importable = async () => existsSync(paths.venvPython) &&
+        (await exec(paths.venvPython, ["-c", "import laya, torch, fastapi, uvicorn"], { timeout: 120_000 })).code === 0;
+    if (!(await importable())) {
+        const python = await findPython(exec, options.python);
+        if (!python) {
+            throw new Error("Laya needs Python 3.10 to 3.13. Install it, or set laya.python to its path.");
+        }
+        report("Creating the Python environment");
+        await run(exec, python[0], [...python[1], "-m", "venv", paths.venv], { signal, timeout: 120_000 }, "Creating the environment failed");
+        const pip = [paths.venvPython, "-m", "pip", "install", "-q", "--disable-pip-version-check"];
+        report("Installing torch (large download)");
+        await run(exec, pip[0], [...pip.slice(1), ...(await torchArgs(exec))], { signal, timeout: PIP_TIMEOUT_MS }, "Installing torch failed");
+        report("Installing Laya");
+        await run(exec, pip[0], [...pip.slice(1), options.manifest.layaPackage, "fastapi", "uvicorn"], { signal, timeout: PIP_TIMEOUT_MS }, "Installing Laya failed");
+    }
+    writeFileSync(paths.serveScript, SERVE_SCRIPT, "utf8");
+    let lastReported = 0;
+    await downloadModel(options.manifest, paths, {
+        fetch: options.fetch,
+        signal,
+        onProgress: (file, received) => {
+            if (file.size < 10_000_000 || received - lastReported < 25_000_000)
+                return;
+            lastReported = received;
+            report(`Downloading the Laya model: ${file.asset} ${Math.round((received / file.size) * 100)}%`);
+        },
+    });
+    return paths;
+}
+/** Serves the model with the System One protocol Relay's `typesafe-system-one` classifier speaks. */
+export const SERVE_SCRIPT = `import argparse
+
+import laya
+import torch
+import uvicorn
+from fastapi import FastAPI, HTTPException
+
+parser = argparse.ArgumentParser()
+parser.add_argument("--model", required=True)
+parser.add_argument("--host", default="127.0.0.1")
+parser.add_argument("--port", type=int, default=8000)
+args = parser.parse_args()
+
+agent = laya.load(args.model, device="cuda" if torch.cuda.is_available() else "cpu")
+app = FastAPI(title="relay-laya")
+
+
+@app.get("/health")
+def health():
+    return {"ok": True, "model": args.model}
+
+
+@app.post("/v1/systemone")
+def system_one(body: dict):
+    if "state" not in body or not body.get("questions"):
+        raise HTTPException(422, "send 'state' and 'questions'")
+    return agent.predict(body["state"], body["questions"])
+
+
+uvicorn.run(app, host=args.host, port=args.port, log_level="warning")
+`;
+//# sourceMappingURL=runtime.js.map