@chernabog/sdk 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chernabog/sdk",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "Services and helpers for writing Chernabog flows and steps",
   "repository": {
@@ -12,7 +12,9 @@
   "exports": {
     ".": "./src/index.ts"
   },
-  "files": ["src"],
+  "files": [
+    "src"
+  ],
   "peerDependencies": {
     "effect": "4.0.5"
   },

package/src/implement.ts

@@ -32,6 +32,7 @@ export const issueItem = (issue: Issue): WorkItem => ({
   title: issue.title,
   url: issue.url,
   data: { issue: issue.number },
+  assignees: issue.assignees,
 });
 
 // The issue number a work item from `trigger` carries.
@@ -50,7 +51,7 @@ export const sessionIdFor = (runId: string, purpose: string) => {
   return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
 };
 
-// Issues labelled eligible, oldest first.
+// Issues labelled eligible, oldest first, each with its assignees.
 export const trigger = GitHub.use((github) => github.queuedIssues).pipe(Effect.map((issues) => issues.map(issueItem)));
 
 // The account is the one machine config expects, and it has room for a task.

package/src/review.ts

@@ -44,6 +44,8 @@ const reviewItem = (pull: PullRequest): WorkItem => ({
   title: pull.title,
   url: pull.url,
   data: { pullRequest: pull.number, headRef: pull.headRef, agentWritten: isAgentBranch(pull.headRef) },
+  assignees: pull.assignees,
+  reviewers: pull.requestedReviewers,
 });
 
 // The head the latest review saw.

package/src/services.ts

@@ -38,7 +38,20 @@ export const Board = Schema.Struct({ projectNumber: Schema.Finite, readyStatus:
 export type Board = typeof Board.Type;
 
 // configDir none is the agent's default home (~/.claude, ~/.codex).
-export const Account = Schema.Struct({ name: Schema.String, configDir: Schema.Option(Schema.String), expectedEmail: Schema.Option(Schema.String) });
+// oauthTokenEnv names the environment variable holding a Claude login token
+// (from `claude setup-token`), for a host with no login of its own, such as CI.
+// usageGate none launches without reading usage, which such a token cannot.
+export const UsageGateMode = Schema.Literals(['usage', 'none']);
+
+export type UsageGateMode = typeof UsageGateMode.Type;
+
+export const Account = Schema.Struct({
+  name: Schema.String,
+  configDir: Schema.Option(Schema.String),
+  expectedEmail: Schema.Option(Schema.String),
+  oauthTokenEnv: Schema.Option(Schema.String),
+  usageGate: UsageGateMode,
+});
 
 export type Account = typeof Account.Type;
 
@@ -117,6 +130,10 @@ export const WorkItem = Schema.Struct({
   signals: Schema.optionalKey(Schema.Array(Schema.String)),
   // Only wakes a run already waiting on it; never starts one.
   wakeOnly: Schema.optionalKey(Schema.Boolean),
+  // GitHub logins assigned to the item, and asked to review it, which
+  // flows.<flow>.assignee and reviewRequested match to choose the machines it starts on.
+  assignees: Schema.optionalKey(Schema.Array(Schema.String)),
+  reviewers: Schema.optionalKey(Schema.Array(Schema.String)),
 });
 
 export type WorkItem = typeof WorkItem.Type;
@@ -134,6 +151,7 @@ export type Issue = {
   readonly url: string;
   readonly createdAt: string;
   readonly labels: ReadonlyArray<string>;
+  readonly assignees: ReadonlyArray<string>;
 };
 
 export type Comment = { readonly id: number; readonly author: string; readonly body: string; readonly createdAt: string; readonly trusted: boolean };
@@ -152,6 +170,9 @@ export type PullRequest = {
   readonly baseRef: string;
   readonly labels: ReadonlyArray<string>;
   readonly author: string;
+  readonly assignees: ReadonlyArray<string>;
+  // Users asked to review it who haven't yet; GitHub drops one once they review.
+  readonly requestedReviewers: ReadonlyArray<string>;
 };
 
 export type ReviewComment = { readonly path: string; readonly line: number; readonly body: string };