cloving 1.2.0 → 1.4.0

package/dist/src/private-config.schema.json

@@ -0,0 +1,303 @@
+{
+    "type": "object",
+    "properties": {
+        "version": {
+            "const": 1
+        },
+        "checks": {
+            "type": "object",
+            "properties": {
+                "beforeMerge": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "required": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "\\S"
+                    }
+                },
+                "redGreen": {
+                    "type": "object",
+                    "properties": {
+                        "test": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "testFiles": {
+                            "type": "array",
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "prepare": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "assertionPattern": {
+                            "type": "string"
+                        },
+                        "skipPattern": {
+                            "type": "string"
+                        }
+                    },
+                    "required": ["test", "testFiles"],
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "tickets": {
+            "type": "object",
+            "properties": {
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "nextCommand": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "queue": {
+            "type": "object",
+            "properties": {
+                "everySeconds": {
+                    "type": "integer",
+                    "minimum": 10,
+                    "maximum": 3600
+                },
+                "dailySpendLimitUsd": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                },
+                "lanes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4
+                }
+            },
+            "additionalProperties": false
+        },
+        "harness": {
+            "type": "object",
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]{0,63}$"
+                },
+                "kind": {
+                    "enum": ["file", "shell"]
+                },
+                "path": {
+                    "type": "string"
+                },
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "turn": {
+                    "type": "array",
+                    "minItems": 1,
+                    "prefixItems": [
+                        {
+                            "type": "string",
+                            "pattern": "^(?!\\{prompt\\}$)[^\\u0000]+$"
+                        }
+                    ],
+                    "items": {
+                        "type": "string",
+                        "pattern": "^[^\\u0000]*$"
+                    },
+                    "contains": {
+                        "const": "{prompt}"
+                    },
+                    "minContains": 0,
+                    "maxContains": 1
+                },
+                "output": {
+                    "const": "text"
+                }
+            },
+            "additionalProperties": false
+        },
+        "profiles": {
+            "type": "object",
+            "propertyNames": {
+                "pattern": "^[A-Za-z0-9_-]{1,119}$"
+            },
+            "additionalProperties": {
+                "type": "object",
+                "properties": {
+                    "harness": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]{0,63}$"
+                    },
+                    "env": {
+                        "type": "object",
+                        "propertyNames": {
+                            "pattern": "^(?!(GH_TOKEN|GITHUB_TOKEN|GH_ENTERPRISE_TOKEN|GITHUB_ENTERPRISE_TOKEN|GH_CONFIG_DIR)$)[A-Za-z_][A-Za-z0-9_]*$"
+                        },
+                        "additionalProperties": {
+                            "type": "string",
+                            "pattern": "^[^\\u0000]*$"
+                        }
+                    },
+                    "allowedTools": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "pattern": "^[^\\u0000]*$"
+                        }
+                    },
+                    "workflows": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "pattern": "^[^\\u0000]*$"
+                        }
+                    },
+                    "model": {
+                        "type": "string",
+                        "pattern": "^[^\\u0000]*$"
+                    },
+                    "permissionMode": {
+                        "type": "string",
+                        "pattern": "^[^\\u0000]*$"
+                    },
+                    "maxBudgetUsd": {
+                        "type": "number",
+                        "exclusiveMinimum": 0
+                    }
+                },
+                "additionalProperties": false
+            }
+        },
+        "fallbackModels": {
+            "type": "array",
+            "maxItems": 3,
+            "items": {
+                "type": "string",
+                "pattern": "\\S"
+            }
+        },
+        "tokenPrices": {
+            "type": "object",
+            "additionalProperties": {
+                "type": "object",
+                "properties": {
+                    "input": {
+                        "type": "number",
+                        "minimum": 0
+                    },
+                    "cachedInput": {
+                        "type": "number",
+                        "minimum": 0
+                    },
+                    "output": {
+                        "type": "number",
+                        "minimum": 0
+                    }
+                },
+                "additionalProperties": false,
+                "required": ["input", "cachedInput", "output"]
+            }
+        },
+        "privateTexts": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        },
+        "notify": {
+            "type": "object",
+            "properties": {
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "watch": {
+            "type": "object",
+            "properties": {
+                "port": {
+                    "anyOf": [
+                        {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 65535
+                        },
+                        {
+                            "const": "off"
+                        }
+                    ]
+                },
+                "actions": {
+                    "enum": ["on", "off"]
+                }
+            },
+            "additionalProperties": false
+        },
+        "selfUpdate": {
+            "type": "object",
+            "properties": {
+                "everySeconds": {
+                    "type": "integer",
+                    "minimum": 30,
+                    "maximum": 3600
+                }
+            },
+            "additionalProperties": false
+        },
+        "github": {
+            "type": "object",
+            "properties": {
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "workflows": {
+            "type": "object",
+            "properties": {
+                "folder": {
+                    "type": "string",
+                    "pattern": "^/"
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "additionalProperties": false,
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Cloving private settings",
+    "required": ["version"]
+}

package/dist/src/project-config.schema.json

@@ -0,0 +1,105 @@
+{
+    "type": "object",
+    "properties": {
+        "version": {
+            "const": 1
+        },
+        "checks": {
+            "type": "object",
+            "properties": {
+                "beforeMerge": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "required": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "pattern": "\\S"
+                    }
+                },
+                "redGreen": {
+                    "type": "object",
+                    "properties": {
+                        "test": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "testFiles": {
+                            "type": "array",
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "prepare": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^[^\\u0000]+$"
+                            }
+                        },
+                        "assertionPattern": {
+                            "type": "string"
+                        },
+                        "skipPattern": {
+                            "type": "string"
+                        }
+                    },
+                    "required": ["test", "testFiles"],
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "tickets": {
+            "type": "object",
+            "properties": {
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "nextCommand": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "queue": {
+            "type": "object",
+            "properties": {
+                "everySeconds": {
+                    "type": "integer",
+                    "minimum": 10,
+                    "maximum": 3600
+                },
+                "dailySpendLimitUsd": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                },
+                "lanes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4
+                }
+            },
+            "additionalProperties": false
+        }
+    },
+    "additionalProperties": false,
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Cloving project settings",
+    "required": ["version"]
+}

package/dist/src/project-settings.d.ts

@@ -0,0 +1,19 @@
+import { type Configuration, type RedGreenSettings } from "./configuration-schema.ts";
+import type { TurnProfiles } from "./turn-profile.ts";
+import type { TokenPrices } from "./token-prices.ts";
+export type SettingSource = "environment" | "private" | "project";
+export type SettingValue = string | number | readonly string[] | TurnProfiles | TokenPrices | RedGreenSettings;
+export declare const settingVariables: Readonly<Record<string, string>>;
+export declare function absoluteWorkflowFolder(folder: string | undefined): string | undefined;
+export declare function configurationRoot(environment: Readonly<NodeJS.ProcessEnv>, home: string): string;
+export declare function parseConfiguration(contents: string | undefined, scope: "project" | "private"): Partial<Configuration>;
+export declare function configurationValues(values: Partial<Configuration>): Readonly<Record<string, SettingValue>>;
+export declare function resolveSettings(environment: Readonly<NodeJS.ProcessEnv>, files: {
+    readonly project: string | undefined;
+    readonly private: string | undefined;
+}): {
+    readonly environment: Readonly<NodeJS.ProcessEnv>;
+    readonly profiles: TurnProfiles;
+    readonly harness?: Configuration["harness"];
+    readonly sources: Readonly<Record<string, SettingSource>>;
+};

package/dist/src/project-settings.js

@@ -0,0 +1,133 @@
+import { configuration, } from "./configuration-schema.js";
+export const settingVariables = {
+    "checks.beforeMerge": "CLOVING_CHECK_COMMAND",
+    "checks.required": "CLOVING_REQUIRED_CHECKS",
+    "checks.redGreen": "CLOVING_RED_GREEN",
+    "tickets.command": "CLOVING_TICKET_COMMAND",
+    "tickets.nextCommand": "CLOVING_NEXT_COMMAND",
+    "queue.everySeconds": "CLOVING_QUEUE_SECONDS",
+    "queue.lanes": "CLOVING_QUEUE_LANES",
+    "queue.dailySpendLimitUsd": "CLOVING_QUEUE_DAILY_SPEND_USD",
+    "harness.name": "CLOVING_WORKER",
+    fallbackModels: "CLOVING_FALLBACK_MODELS",
+    tokenPrices: "CLOVING_TOKEN_PRICES",
+    privateTexts: "CLOVING_PRIVATE_TEXTS",
+    "notify.command": "CLOVING_NOTIFY_COMMAND",
+    "watch.port": "CLOVING_WATCH_PORT",
+    "watch.actions": "CLOVING_WATCH_ACTIONS",
+    "selfUpdate.everySeconds": "CLOVING_SELF_UPDATE_SECONDS",
+    "github.command": "CLOVING_GH_COMMAND",
+    "workflows.folder": "CLOVING_WORKFLOW_FOLDER",
+};
+const environmentOnly = [
+    "CLOVING_RUNTIME_DIR",
+    "CLOVING_OWNERSHIP_LEASE_SECONDS",
+    "CLOVING_HOST_BOUND",
+    "CLOVING_WATCH_REPOSITORY",
+    "CLOVING_COMMANDS",
+    "CLOVING_COMMAND_SECONDS",
+    "CLOVING_SCHEDULES",
+    "CLOVING_PHONE_RELAY",
+    "CLOVING_RELAY_ORIGIN",
+];
+export function absoluteWorkflowFolder(folder) {
+    if (folder === undefined || folder.startsWith("/"))
+        return folder;
+    throw new Error("invalid-setting: CLOVING_WORKFLOW_FOLDER must be an absolute path");
+}
+export function configurationRoot(environment, home) {
+    const configured = environment["XDG_CONFIG_HOME"];
+    return configured?.startsWith("/")
+        ? configured
+        : `${environment["HOME"] ?? home}/.config`;
+}
+export function parseConfiguration(contents, scope) {
+    if (contents === undefined)
+        return {};
+    let value;
+    try {
+        value = JSON.parse(contents);
+    }
+    catch {
+        throw new Error(`invalid-config-json: ${scope}`);
+    }
+    return configuration(value, scope);
+}
+export function configurationValues(values) {
+    const entries = [];
+    const groups = {
+        checks: values.checks,
+        tickets: values.tickets,
+        queue: values.queue,
+        harness: values.harness,
+        notify: values.notify,
+        watch: values.watch,
+        selfUpdate: values.selfUpdate,
+        github: values.github,
+        workflows: values.workflows,
+    };
+    for (const [name, group] of Object.entries(groups)) {
+        if (group === undefined)
+            continue;
+        for (const [child, item] of Object.entries(group))
+            entries.push([`${name}.${child}`, item]);
+    }
+    const direct = {
+        profiles: values.profiles,
+        fallbackModels: values.fallbackModels,
+        tokenPrices: values.tokenPrices,
+        privateTexts: values.privateTexts,
+    };
+    for (const [name, value] of Object.entries(direct))
+        if (value !== undefined)
+            entries.push([name, value]);
+    return Object.fromEntries(entries);
+}
+function encoded(value) {
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+function harnessCommandMapping(name) {
+    if (name === "opencode")
+        return { "harness.command": "CLOVING_OPENCODE_COMMAND" };
+    if (name === "grok")
+        return { "harness.command": "CLOVING_GROK_COMMAND" };
+    if (name === "codex")
+        return { "harness.command": "CLOVING_CODEX_COMMAND" };
+    if (name === "gemini")
+        return { "harness.command": "CLOVING_GEMINI_COMMAND" };
+    if (name === undefined || name === "claude")
+        return { "harness.command": "CLOVING_CLAUDE_COMMAND" };
+    return {};
+}
+export function resolveSettings(environment, files) {
+    const project = configurationValues(parseConfiguration(files.project, "project"));
+    const privateConfiguration = parseConfiguration(files.private, "private");
+    const privateFile = configurationValues(privateConfiguration);
+    const values = { ...project, ...privateFile };
+    const resolved = { ...environment };
+    const sources = {};
+    const mapped = {
+        ...settingVariables,
+        ...harnessCommandMapping(values["harness.name"]),
+        profiles: "CLOVING_PROFILES",
+        ...Object.fromEntries(environmentOnly.map((name) => [name, name])),
+    };
+    for (const field of Object.keys(values))
+        sources[field] = Object.hasOwn(privateFile, field) ? "private" : "project";
+    for (const [field, variable] of Object.entries(mapped)) {
+        const value = values[field];
+        if (environment[variable] !== undefined)
+            sources[field] = "environment";
+        else if (field !== "profiles" && value !== undefined)
+            resolved[variable] = encoded(value);
+    }
+    const profiles = privateConfiguration.profiles ?? {};
+    return {
+        environment: resolved,
+        profiles,
+        sources,
+        ...(privateConfiguration.harness === undefined
+            ? {}
+            : { harness: privateConfiguration.harness }),
+    };
+}

package/dist/src/queue-spend.d.ts

@@ -0,0 +1,4 @@
+export declare function queueSpending(costs: readonly number[], limitUsd: number): {
+    readonly spentUsd: number;
+    readonly holding: boolean;
+};

package/dist/src/queue-spend.js

@@ -0,0 +1,21 @@
+function decimal(value) {
+    const [mantissa = "0", exponent = "0"] = String(value).split("e");
+    const fraction = mantissa.split(".")[1]?.length ?? 0;
+    return {
+        units: BigInt(mantissa.replace(".", "")),
+        exponent: Number(exponent) - fraction,
+    };
+}
+function scaled(value, exponent) {
+    return value.units * 10n ** BigInt(value.exponent - exponent);
+}
+export function queueSpending(costs, limitUsd) {
+    const prices = costs.map(decimal);
+    const limit = decimal(limitUsd);
+    const exponent = prices.reduce((smallest, price) => Math.min(smallest, price.exponent), limit.exponent);
+    const total = prices.reduce((sum, price) => sum + scaled(price, exponent), 0n);
+    return {
+        spentUsd: Number(`${String(total)}e${String(exponent)}`),
+        holding: total * 100n >= scaled(limit, exponent) * 85n,
+    };
+}

package/dist/src/relay/answer-check.d.ts

@@ -0,0 +1,24 @@
+import { type Fields } from "../protocol.ts";
+import type { PhoneDevice } from "./phone-devices.ts";
+export interface SignedAnswerMessage {
+    readonly payload: string;
+    readonly signature: string;
+}
+export interface AnswerScope {
+    readonly daemonId: string;
+    readonly routedDeviceId: string;
+    readonly devices: readonly PhoneDevice[];
+    readonly now: number;
+    readonly sentPromptDigest: string | null;
+}
+export type AnswerVerdict = {
+    readonly kind: "decision";
+    readonly decisionId: string;
+    readonly parameters: Fields;
+} | {
+    readonly kind: "refused";
+    readonly code: string;
+    readonly decisionId: string | null;
+};
+export declare function answerDecisionId(message: SignedAnswerMessage): string | null;
+export declare function answerVerdict(message: SignedAnswerMessage, scope: AnswerScope): AnswerVerdict;