@usine/core 0.2.0 → 0.4.0

package/dist/step/result.d.ts

@@ -3,7 +3,7 @@ declare const Commit_base: Schema.Class<Commit, Schema.TaggedStruct<"Commit", {
     readonly sha: Schema.brand<Schema.String, "CommitSha">;
     readonly summary: Schema.NonEmptyString;
 }>, {}>;
-/** A commit the run host found between the workspace base and final HEAD. */
+/** A commit between the workspace base and the final HEAD. */
 export declare class Commit extends Commit_base {
 }
 declare const PullRequest_base: Schema.Class<PullRequest, Schema.TaggedStruct<"PullRequest", {
@@ -13,20 +13,31 @@ declare const PullRequest_base: Schema.Class<PullRequest, Schema.TaggedStruct<"P
 /** A pull request the agent created or updated during the Attempt. */
 export declare class PullRequest extends PullRequest_base {
 }
+/**
+ * - `issue-comment`: in an issue or pull request conversation.
+ * - `review`: a submitted pull request review.
+ * - `review-comment`: on a line of a pull request diff, including replies in a review thread.
+ */
+export declare const CommentKind: Schema.Literals<readonly ["issue-comment", "review", "review-comment"]>;
+export type CommentKind = typeof CommentKind.Type;
 declare const Comment_base: Schema.Class<Comment, Schema.TaggedStruct<"Comment", {
     readonly url: Schema.URLFromString;
+    readonly kind: Schema.Literals<readonly ["issue-comment", "review", "review-comment"]>;
+    readonly at: Schema.OptionFromOptionalKey<Schema.DateTimeUtcFromString>;
 }>, {}>;
-/** A GitHub comment the agent created or updated during the Attempt. */
+/**
+ * A GitHub comment or review that the agent created or updated on the Run's Item. `at` is the
+ * creation time of a comment or submission time of a review, or `None` for older records.
+ */
 export declare class Comment extends Comment_base {
 }
-/** A commit or GitHub artifact recorded as an outcome of the Agent's work. */
 export declare const StepResultFact: Schema.Union<readonly [typeof Commit, typeof PullRequest, typeof Comment]>;
 export type StepResultFact = typeof StepResultFact.Type;
 declare const StepResult_base: Schema.Class<StepResult, Schema.Struct<{
     readonly message: Schema.NonEmptyString;
     readonly facts: Schema.$Array<Schema.Union<readonly [typeof Commit, typeof PullRequest, typeof Comment]>>;
 }>, {}>;
-/** The agent's final message plus the facts that survive workspace cleanup. */
+/** The agent's final message and the facts kept after workspace cleanup. */
 export declare class StepResult extends StepResult_base {
 }
 export {};

package/dist/step/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/step/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAGhC,6EAA6E;AAC7E,qBAAa,MAAO,SAAQ,WAG1B;CAAG;;;;;AAEL,sEAAsE;AACtE,qBAAa,WAAY,SAAQ,gBAMhC;CAAG;;;;AAEJ,wEAAwE;AACxE,qBAAa,OAAQ,SAAQ,YAE3B;CAAG;AAEL,8EAA8E;AAC9E,eAAO,MAAM,cAAc,4EAA+C,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;;;;;AAExD,+EAA+E;AAC/E,qBAAa,UAAW,SAAQ,eAG9B;CAAG"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/step/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAGhC,8DAA8D;AAC9D,qBAAa,MAAO,SAAQ,WAG1B;CAAG;;;;;AAEL,sEAAsE;AACtE,qBAAa,WAAY,SAAQ,gBAMhC;CAAG;AAEJ;;;;GAIG;AACH,eAAO,MAAM,WAAW,yEAAiE,CAAC;AAC1F,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;;;;;;AAElD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAI3B;CAAG;AAEL,eAAO,MAAM,cAAc,4EAA+C,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;;;;;AAExD,4EAA4E;AAC5E,qBAAa,UAAW,SAAQ,eAG9B;CAAG"}

package/dist/step/result.js

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 import { CommitSha } from "../repository.js";
-/** A commit the run host found between the workspace base and final HEAD. */
+/** A commit between the workspace base and the final HEAD. */
 export class Commit extends Schema.TaggedClass("StepResult/Commit")("Commit", {
     sha: CommitSha,
     summary: Schema.NonEmptyString,
@@ -12,14 +12,24 @@ export class PullRequest extends Schema.TaggedClass("StepResult/PullRequest")("P
     url: Schema.URLFromString,
 }) {
 }
-/** A GitHub comment the agent created or updated during the Attempt. */
+/**
+ * - `issue-comment`: in an issue or pull request conversation.
+ * - `review`: a submitted pull request review.
+ * - `review-comment`: on a line of a pull request diff, including replies in a review thread.
+ */
+export const CommentKind = Schema.Literals(["issue-comment", "review", "review-comment"]);
+/**
+ * A GitHub comment or review that the agent created or updated on the Run's Item. `at` is the
+ * creation time of a comment or submission time of a review, or `None` for older records.
+ */
 export class Comment extends Schema.TaggedClass("StepResult/Comment")("Comment", {
     url: Schema.URLFromString,
+    kind: CommentKind,
+    at: Schema.OptionFromOptionalKey(Schema.DateTimeUtcFromString),
 }) {
 }
-/** A commit or GitHub artifact recorded as an outcome of the Agent's work. */
 export const StepResultFact = Schema.Union([Commit, PullRequest, Comment]);
-/** The agent's final message plus the facts that survive workspace cleanup. */
+/** The agent's final message and the facts kept after workspace cleanup. */
 export class StepResult extends Schema.Class("StepResult")({
     message: Schema.NonEmptyString,
     facts: Schema.Array(StepResultFact),

package/dist/step/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/step/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,6EAA6E;AAC7E,MAAM,OAAO,MAAO,SAAQ,MAAM,CAAC,WAAW,CAAS,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IACpF,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAc,wBAAwB,CAAC,CACxF,aAAa,EACb;IACE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1D,GAAG,EAAE,MAAM,CAAC,aAAa;CAC1B,CACF;CAAG;AAEJ,wEAAwE;AACxE,MAAM,OAAO,OAAQ,SAAQ,MAAM,CAAC,WAAW,CAAU,oBAAoB,CAAC,CAAC,SAAS,EAAE;IACxF,GAAG,EAAE,MAAM,CAAC,aAAa;CAC1B,CAAC;CAAG;AAEL,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAG3E,+EAA+E;AAC/E,MAAM,OAAO,UAAW,SAAQ,MAAM,CAAC,KAAK,CAAa,YAAY,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;CACpC,CAAC;CAAG"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/step/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,8DAA8D;AAC9D,MAAM,OAAO,MAAO,SAAQ,MAAM,CAAC,WAAW,CAAS,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IACpF,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAc,wBAAwB,CAAC,CACxF,aAAa,EACb;IACE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1D,GAAG,EAAE,MAAM,CAAC,aAAa;CAC1B,CACF;CAAG;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAG1F;;;GAGG;AACH,MAAM,OAAO,OAAQ,SAAQ,MAAM,CAAC,WAAW,CAAU,oBAAoB,CAAC,CAAC,SAAS,EAAE;IACxF,GAAG,EAAE,MAAM,CAAC,aAAa;IACzB,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,qBAAqB,CAAC;CAC/D,CAAC;CAAG;AAEL,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAG3E,4EAA4E;AAC5E,MAAM,OAAO,UAAW,SAAQ,MAAM,CAAC,KAAK,CAAa,YAAY,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;CACpC,CAAC;CAAG"}

package/dist/step/step.d.ts

@@ -1,9 +1,6 @@
 import { Schema } from "effect";
 import { StepResult } from "./result.ts";
-/**
- * The loop-authored step name. Renaming a step in the loop file retires it and
- * its stored results stay under the old name (ADR 0002).
- */
+/** The step name from the loop file. After a rename, stored results stay under the old name (ADR 0002). */
 export declare const StepName: Schema.brand<Schema.NonEmptyString, "StepName">;
 export type StepName = typeof StepName.Type;
 declare const Step_base: Schema.Class<Step, Schema.Struct<{
@@ -11,10 +8,7 @@ declare const Step_base: Schema.Class<Step, Schema.Struct<{
     readonly name: Schema.brand<Schema.NonEmptyString, "StepName">;
     readonly result: Schema.Option<typeof StepResult>;
 }>, {}>;
-/**
- * A named unit of work inside a run, exactly one per run in v1. The result is
- * stored when an attempt succeeds and is none until then.
- */
+/** A unit of work in a Run, exactly one per Run in v1. `result` is `None` until an Attempt succeeds. */
 export declare class Step extends Step_base {
 }
 export {};

package/dist/step/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/step/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,QAAQ,iDAAuD,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;;;;;;AAE5C;;;GAGG;AACH,qBAAa,IAAK,SAAQ,SAIxB;CAAG"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/step/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,2GAA2G;AAC3G,eAAO,MAAM,QAAQ,iDAAuD,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;;;;;;AAE5C,wGAAwG;AACxG,qBAAa,IAAK,SAAQ,SAIxB;CAAG"}

package/dist/step/step.js

@@ -1,15 +1,9 @@
 import { Schema } from "effect";
 import { RunId } from "../run/run.js";
 import { StepResult } from "./result.js";
-/**
- * The loop-authored step name. Renaming a step in the loop file retires it and
- * its stored results stay under the old name (ADR 0002).
- */
+/** The step name from the loop file. After a rename, stored results stay under the old name (ADR 0002). */
 export const StepName = Schema.NonEmptyString.pipe(Schema.brand("StepName"));
-/**
- * A named unit of work inside a run, exactly one per run in v1. The result is
- * stored when an attempt succeeds and is none until then.
- */
+/** A unit of work in a Run, exactly one per Run in v1. `result` is `None` until an Attempt succeeds. */
 export class Step extends Schema.Class("Step")({
     runId: RunId,
     name: StepName,

package/dist/step/step.js.map

@@ -1 +1 @@
-{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/step/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAI7E;;;GAGG;AACH,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,KAAK,CAAO,MAAM,CAAC,CAAC;IACnD,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAClC,CAAC;CAAG"}
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/step/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,2GAA2G;AAC3G,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAI7E,wGAAwG;AACxG,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,KAAK,CAAO,MAAM,CAAC,CAAC;IACnD,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAClC,CAAC;CAAG"}

package/dist/worker.d.ts

@@ -1,9 +1,53 @@
 import { Schema } from "effect";
-/** Kebab-case name of a configured Worker. */
 export declare const WorkerName: Schema.brand<Schema.String, "WorkerName">;
 export type WorkerName = typeof WorkerName.Type;
-/** The Worker adapters the engine ships. */
-export declare const WORKER_KINDS: readonly ["local", "exe.dev"];
-export declare const WorkerKind: Schema.Literals<readonly ["local", "exe.dev"]>;
+export declare const WORKER_KINDS: readonly ["local", "exe.dev", "ssh"];
+export declare const WorkerKind: Schema.Literals<readonly ["local", "exe.dev", "ssh"]>;
 export type WorkerKind = typeof WorkerKind.Type;
+/**
+ * The GitHub bot login that an Attempt writes as: the factory's GitHub App on local and SSH
+ * Workers, or the exe.dev GitHub integration on exe.dev Workers (ADR 0011).
+ */
+export declare const BotLogin: Schema.brand<Schema.String, "BotLogin">;
+export type BotLogin = typeof BotLogin.Type;
+/**
+ * The `ssh` destination: a host name, address, or SSH config Host alias, optionally prefixed
+ * with `user@`. Rejects values that `ssh` could parse as an option, such as `-oProxyCommand=...`.
+ */
+export declare const SshDestination: Schema.brand<Schema.String, "SshDestination">;
+export type SshDestination = typeof SshDestination.Type;
+export declare const SshPort: Schema.brand<Schema.Int, "SshPort">;
+export type SshPort = typeof SshPort.Type;
+/** The `ssh` private key path, absolute or starting with `~/`. */
+export declare const SshIdentityFile: Schema.brand<Schema.String, "SshIdentityFile">;
+export type SshIdentityFile = typeof SshIdentityFile.Type;
+/**
+ * The absolute directory on the Worker's machine that contains `workers/<worker>`, with cached
+ * clones, Attempt checkouts, and Attempt credentials.
+ */
+export declare const WorkerRoot: Schema.brand<Schema.String, "WorkerRoot">;
+export type WorkerRoot = typeof WorkerRoot.Type;
+/**
+ * The Gateway's private DNS domain, which serves `git.<domain>` for GitHub, `llm.<domain>` for
+ * LLM providers, and `<domain>` for the forward proxy
+ * ([ADR 0027](../../../docs/adr/0027-gateway-credential-proxy.md)).
+ */
+export declare const GatewayDomain: Schema.brand<Schema.String, "GatewayDomain">;
+export type GatewayDomain = typeof GatewayDomain.Type;
+/** The Gateway admin API port on the Gateway's loopback interface (`USINE_GATEWAY_ADMIN_PORT`), used through an SSH forward. */
+export declare const GatewayAdminPort: Schema.brand<Schema.Int, "GatewayAdminPort">;
+export type GatewayAdminPort = typeof GatewayAdminPort.Type;
+/**
+ * An LLM provider whose credential the Gateway stores. The harness for that provider, such as
+ * Claude Code for `anthropic`, uses the Attempt's caller token instead of a login on the machine.
+ */
+export declare const GatewayLlmProvider: Schema.Literals<readonly ["anthropic"]>;
+export type GatewayLlmProvider = typeof GatewayLlmProvider.Type;
+/**
+ * The kind of LLM provider credential that the Gateway stores, as reported by its admin API.
+ * `api-key` is billed at API rates; `subscription` uses a plan, such as a Claude plan from
+ * `claude setup-token` ([ADR 0013](../../../docs/adr/0013-cost-accounting-native-meters-guardrails.md)).
+ */
+export declare const GatewayCredentialKind: Schema.Literals<readonly ["api-key", "subscription"]>;
+export type GatewayCredentialKind = typeof GatewayCredentialKind.Type;
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,8CAA8C;AAC9C,eAAO,MAAM,UAAU,2CAIW,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,YAAY,YAAI,OAAO,EAAE,SAAS,CAAU,CAAC;AAC1D,eAAO,MAAM,UAAU,gDAAgC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,UAAU,2CAIW,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,eAAO,MAAM,YAAY,YAAI,OAAO,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AACjE,eAAO,MAAM,UAAU,uDAAgC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,QAAQ,yCAIW,CAAC;AACjC,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,cAAc,+CAIW,CAAC;AACvC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAExD,eAAO,MAAM,OAAO,qCAEnB,CAAC;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,eAAe,gDAIW,CAAC;AACxC,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,UAAU,2CAIW,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,aAAa,8CAKW,CAAC;AACtC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AAEtD,gIAAgI;AAChI,eAAO,MAAM,gBAAgB,8CAEW,CAAC;AACzC,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yCAAiC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,uDAA+C,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC"}

package/dist/worker.js

@@ -1,9 +1,52 @@
 import { Schema } from "effect";
-/** Kebab-case name of a configured Worker. */
 export const WorkerName = Schema.String.check(Schema.isPattern(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u, {
-    message: "Expected a kebab-case Worker name",
+    message: "Expected a kebab-case worker name",
 })).pipe(Schema.brand("WorkerName"));
-/** The Worker adapters the engine ships. */
-export const WORKER_KINDS = ["local", "exe.dev"];
+export const WORKER_KINDS = ["local", "exe.dev", "ssh"];
 export const WorkerKind = Schema.Literals(WORKER_KINDS);
+/**
+ * The GitHub bot login that an Attempt writes as: the factory's GitHub App on local and SSH
+ * Workers, or the exe.dev GitHub integration on exe.dev Workers (ADR 0011).
+ */
+export const BotLogin = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?\[bot\]$/u, {
+    message: "Expected a GitHub bot login: <slug>[bot]",
+})).pipe(Schema.brand("BotLogin"));
+/**
+ * The `ssh` destination: a host name, address, or SSH config Host alias, optionally prefixed
+ * with `user@`. Rejects values that `ssh` could parse as an option, such as `-oProxyCommand=...`.
+ */
+export const SshDestination = Schema.String.check(Schema.isPattern(/^(?:[A-Za-z0-9._-]+@)?[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?$/u, {
+    message: "Expected an SSH destination: a host name or address, optionally prefixed by a user",
+})).pipe(Schema.brand("SshDestination"));
+export const SshPort = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65_535 })).pipe(Schema.brand("SshPort"));
+/** The `ssh` private key path, absolute or starting with `~/`. */
+export const SshIdentityFile = Schema.String.check(Schema.isPattern(/^(?:\/|~\/)[!-~]+$/u, {
+    message: "Expected an absolute or ~/ key path without spaces or control characters",
+})).pipe(Schema.brand("SshIdentityFile"));
+/**
+ * The absolute directory on the Worker's machine that contains `workers/<worker>`, with cached
+ * clones, Attempt checkouts, and Attempt credentials.
+ */
+export const WorkerRoot = Schema.String.check(Schema.isPattern(/^(?:\/[!-.0-~]+)+$/u, {
+    message: "Expected an absolute directory without spaces, control characters, or a trailing /",
+})).pipe(Schema.brand("WorkerRoot"));
+/**
+ * The Gateway's private DNS domain, which serves `git.<domain>` for GitHub, `llm.<domain>` for
+ * LLM providers, and `<domain>` for the forward proxy
+ * ([ADR 0027](../../../docs/adr/0027-gateway-credential-proxy.md)).
+ */
+export const GatewayDomain = Schema.String.check(Schema.isPattern(/^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u, { message: "Expected a lowercase DNS domain" })).pipe(Schema.brand("GatewayDomain"));
+/** The Gateway admin API port on the Gateway's loopback interface (`USINE_GATEWAY_ADMIN_PORT`), used through an SSH forward. */
+export const GatewayAdminPort = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65_535 })).pipe(Schema.brand("GatewayAdminPort"));
+/**
+ * An LLM provider whose credential the Gateway stores. The harness for that provider, such as
+ * Claude Code for `anthropic`, uses the Attempt's caller token instead of a login on the machine.
+ */
+export const GatewayLlmProvider = Schema.Literals(["anthropic"]);
+/**
+ * The kind of LLM provider credential that the Gateway stores, as reported by its admin API.
+ * `api-key` is billed at API rates; `subscription` uses a plan, such as a Claude plan from
+ * `claude setup-token` ([ADR 0013](../../../docs/adr/0013-cost-accounting-native-meters-guardrails.md)).
+ */
+export const GatewayCredentialKind = Schema.Literals(["api-key", "subscription"]);
 //# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC3C,MAAM,CAAC,SAAS,CAAC,6BAA6B,EAAE;IAC9C,OAAO,EAAE,mCAAmC;CAC7C,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AAInC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC3C,MAAM,CAAC,SAAS,CAAC,6BAA6B,EAAE;IAC9C,OAAO,EAAE,mCAAmC;CAC7C,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AAInC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CACzC,MAAM,CAAC,SAAS,CAAC,oDAAoD,EAAE;IACrE,OAAO,EAAE,0CAA0C;CACpD,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAGjC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC/C,MAAM,CAAC,SAAS,CAAC,mEAAmE,EAAE;IACpF,OAAO,EAAE,oFAAoF;CAC9F,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAGvC,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAC7F,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CACxB,CAAC;AAGF,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAChD,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE;IACtC,OAAO,EAAE,0EAA0E;CACpF,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAGxC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC3C,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE;IACtC,OAAO,EAAE,oFAAoF;CAC9F,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AAGnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC9C,MAAM,CAAC,SAAS,CACd,oFAAoF,EACpF,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAC/C,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AAGtC,gIAAgI;AAChI,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAC9C,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAClD,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAGjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usine/core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Domain model for usine: Event → Run → Step → Attempt, branded ids, the run state machine, and the typed attempt-failure taxonomy.",
   "license": "MIT",
   "repository": {
@@ -9,7 +9,8 @@
     "directory": "packages/core"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/tsconfig.tsbuildinfo"
   ],
   "type": "module",
   "sideEffects": false,
@@ -46,6 +47,14 @@
       "types": "./dist/attempt/outcome.d.ts",
       "default": "./dist/attempt/outcome.js"
     },
+    "./attempt/salvage": {
+      "types": "./dist/attempt/salvage.d.ts",
+      "default": "./dist/attempt/salvage.js"
+    },
+    "./attempt/start": {
+      "types": "./dist/attempt/start.d.ts",
+      "default": "./dist/attempt/start.js"
+    },
     "./event": {
       "types": "./dist/event.d.ts",
       "default": "./dist/event.js"
@@ -62,6 +71,10 @@
       "types": "./dist/loop.d.ts",
       "default": "./dist/loop.js"
     },
+    "./operator": {
+      "types": "./dist/operator.d.ts",
+      "default": "./dist/operator.js"
+    },
     "./repository": {
       "types": "./dist/repository.d.ts",
       "default": "./dist/repository.js"
@@ -74,6 +87,14 @@
       "types": "./dist/run/state.d.ts",
       "default": "./dist/run/state.js"
     },
+    "./run/approval": {
+      "types": "./dist/run/approval.d.ts",
+      "default": "./dist/run/approval.js"
+    },
+    "./run/again": {
+      "types": "./dist/run/again.d.ts",
+      "default": "./dist/run/again.js"
+    },
     "./step": {
       "types": "./dist/step/step.d.ts",
       "default": "./dist/step/step.js"
@@ -82,6 +103,10 @@
       "types": "./dist/step/result.d.ts",
       "default": "./dist/step/result.js"
     },
+    "./step/harvest": {
+      "types": "./dist/step/harvest.d.ts",
+      "default": "./dist/step/harvest.js"
+    },
     "./worker": {
       "types": "./dist/worker.d.ts",
       "default": "./dist/worker.js"