@h-rig/contracts 0.0.6-alpha.157 → 0.0.6-alpha.158

package/dist/src/run-discovery.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Run-discovery capability seam.
+ *
+ * Contracts-native types for the RUN_DISCOVERY service: inline structural
+ * equivalents of the @oh-my-pi and @rig/relay-registry types. We define
+ * them here rather than importing from those packages to keep @rig/contracts
+ * floor-neutral (@rig/relay-registry depends on @rig/contracts — importing
+ * relay-registry here would be circular; @oh-my-pi is a vendor package that
+ * doesn't belong on the floor).
+ *
+ * TypeScript's structural type system makes these compatible with the
+ * corresponding @oh-my-pi / relay-registry types at the impl site.
+ *
+ * Pure: types + one branded id, no behaviour.
+ */
+import type { CapabilityId } from "./capability-id";
+import type { Stream } from "effect";
+/** Structural equivalent of @oh-my-pi CollabRegistryFilter. */
+export interface RunDiscoveryFilter {
+    githubUserId?: string;
+    namespaceKey?: string;
+    selectedRepo?: string;
+    cwd?: string;
+}
+/** Structural equivalent of @oh-my-pi LiveCollabOwner. */
+export interface RunDiscoveryOwner {
+    githubUserId?: string;
+    login?: string;
+    namespaceKey?: string;
+}
+/** Structural equivalent of @oh-my-pi LiveCollabProjection. */
+export interface LiveRunCollabProjection {
+    sessionId: string;
+    sessionPath: string;
+    cwd: string;
+    title: string;
+    joinLink: string;
+    webLink: string;
+    relayUrl?: string;
+    owner?: RunDiscoveryOwner;
+    selectedRepo?: string;
+    startedAt: string;
+    updatedAt: string;
+    pid?: number;
+    stale: boolean;
+}
+/** Input for attaching to a run via the relay (structural equiv of AttachViaRelayInput). */
+export interface RigRunAttachInput {
+    readonly runId: string;
+    readonly taskId?: string | null;
+    readonly identityFilter: RunDiscoveryFilter;
+    readonly timeoutMs?: number;
+    readonly projectRoot?: string;
+}
+/** Result of a relay attach (structural equiv of RigExtensionAttachResult). */
+export interface RigRunAttachResult {
+    readonly sessionPath: string | null;
+    readonly joinLink: string | null;
+    readonly collabSessionId: string | null;
+}
+/**
+ * The run-discovery service surface: the unified active-run list (local FS +
+ * remote registry) and relay attach. registrySnapshotStream is intentionally
+ * omitted — its entry type (`RegistrySnapshotFrame` from @rig/relay-registry)
+ * cannot be referenced here without creating a circular dep; consumers that
+ * need snapshot frames must cast through the transport-plugin's richer type.
+ */
+export interface RunDiscoveryService {
+    readonly listActiveRunCollab: (projectRoot: string, filter: RunDiscoveryFilter) => Promise<readonly LiveRunCollabProjection[]>;
+    readonly runDiscoveryStream: (projectRoot: string) => Stream.Stream<void>;
+    readonly attachViaRelay: (input: RigRunAttachInput) => Promise<RigRunAttachResult | null>;
+}
+/** Stable id string for the run-discovery service capability. */
+export declare const RUN_DISCOVERY_CAPABILITY_ID = "rig.runs.discovery";
+/**
+ * The branded run-discovery capability id. `defineCapability(RUN_DISCOVERY)`
+ * (provider and consumers independently) resolves to a `RunDiscoveryService`.
+ */
+export declare const RUN_DISCOVERY: CapabilityId<RunDiscoveryService>;

package/dist/src/run-discovery.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/run-discovery.ts
+var RUN_DISCOVERY_CAPABILITY_ID = "rig.runs.discovery";
+var RUN_DISCOVERY = makeCapabilityId(RUN_DISCOVERY_CAPABILITY_ID);
+export {
+  RUN_DISCOVERY_CAPABILITY_ID,
+  RUN_DISCOVERY
+};

package/dist/src/run-dispatch.d.ts

@@ -0,0 +1,34 @@
+/**
+ * run-dispatch.ts — pure capability vocabulary for placement-aware run dispatch.
+ *
+ * The dispatch IMPL (local + remote placement, run-process spawn, session-id
+ * wait) lives in @rig/transport-plugin (`./dispatch`, the `transport` backbone).
+ * Programmatic consumers (rig-extension, supervisor) resolve it off a project's
+ * plugin host under {@link RUN_DISPATCH_CAPABILITY_ID} — WITHOUT importing the
+ * transport plugin's impl. This file holds ONLY the pure id + interface shared
+ * by the provider and its consumers (no IO, no plugin imports).
+ */
+import type { CapabilityId } from "./capability-id";
+/** The placement-aware run dispatch input (plain, OMP-type-free). */
+export interface RunDispatchInput {
+    readonly projectRoot: string;
+    readonly taskId: string;
+    readonly title?: string | null;
+    readonly model?: string | null;
+    readonly prompt?: string | null;
+    readonly force?: boolean;
+}
+/**
+ * The host-resolved run-dispatch surface: dispatch a run (resolving local vs
+ * remote/fleet placement at dispatch time) and resolve once an OMP session id
+ * has appeared. Mirrors `dispatchRun` in @rig/transport-plugin.
+ */
+export interface RunDispatchService {
+    readonly dispatchRun: (input: RunDispatchInput) => Promise<{
+        readonly runId: string;
+    }>;
+}
+/** The capability id the transport plugin registers its run dispatcher under. */
+export declare const RUN_DISPATCH_CAPABILITY_ID = "rig.runs.dispatch";
+/** Phantom-typed id; string value is {@link RUN_DISPATCH_CAPABILITY_ID}. */
+export declare const RUN_DISPATCH: CapabilityId<RunDispatchService>;

package/dist/src/run-dispatch.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/run-dispatch.ts
+var RUN_DISPATCH_CAPABILITY_ID = "rig.runs.dispatch";
+var RUN_DISPATCH = makeCapabilityId(RUN_DISPATCH_CAPABILITY_ID);
+export {
+  RUN_DISPATCH_CAPABILITY_ID,
+  RUN_DISPATCH
+};

package/dist/src/run-identity.d.ts

@@ -0,0 +1,47 @@
+/**
+ * cap:run-identity-env — GitHub/Rig run identity capability seam.
+ *
+ * The CLI seed and sibling plugins must not implement GitHub identity policy or
+ * import a provider implementation directly. The identity owner
+ * (`@rig/github-provider-plugin`) registers this capability with public
+ * identity-env hydration, run-child credential stripping, and runtime identity
+ * resolution. This file holds ONLY pure seam vocabulary — no IO.
+ */
+import type { CapabilityId } from "./capability-id";
+import type { RigIdentityContext, RigResolvedIdentity } from "./identity";
+/** Structural mirror of `@rig/relay-registry`'s `CollabRegistryFilter` (no transport dep). */
+export type IdentityRegistryFilter = {
+    readonly cwd?: string;
+    readonly selectedRepo?: string;
+    readonly githubUserId?: string;
+    readonly namespaceKey?: string;
+};
+/** Capability id the identity owner registers its run identity policy under. */
+export declare const RUN_IDENTITY_ENV_CAPABILITY_ID = "cap:run-identity-env";
+/** GitHub/Rig identity operations consumers resolve through the provider capability. */
+export interface RunIdentityEnvService {
+    /**
+     * Resolve public identity env vars for `workspaceRoot` without mutating
+     * process.env.
+     */
+    resolveIdentityEnv(workspaceRoot: string): Partial<Record<"RIG_SELECTED_REPO" | "RIG_GITHUB_USER_ID" | "RIG_GITHUB_LOGIN" | "RIG_GITHUB_NAMESPACE_KEY", string>>;
+    /**
+     * Hydrate the public-identity env vars for `workspaceRoot` into process.env
+     * (RIG_SELECTED_REPO / RIG_GITHUB_USER_ID / RIG_GITHUB_LOGIN / namespace key /
+     * auth-state-file pointer). Returns a restore closure that reverts the change.
+     */
+    applyIdentityEnv(workspaceRoot: string): () => void;
+    /** Build a registry discovery filter from the current public identity env. */
+    identityFilterFromEnv(): IdentityRegistryFilter;
+    /**
+     * Return a copy of `env` (default process.env) with the run-scoped credential
+     * tokens removed, for use as a spawned run-host child's environment.
+     */
+    stripRunChildCredentialEnv(env?: Record<string, string | undefined>): Record<string, string | undefined>;
+    /** Resolve the current Rig run identity from the OMP session/auth context. */
+    resolveRigIdentity(ctx: RigIdentityContext): RigResolvedIdentity | null;
+    /** Resolve the registry filter corresponding to the current Rig run identity. */
+    resolveRigIdentityFilter(ctx: RigIdentityContext): IdentityRegistryFilter | null;
+}
+/** Typed capability id; string value is {@link RUN_IDENTITY_ENV_CAPABILITY_ID}. */
+export declare const RUN_IDENTITY_ENV: CapabilityId<RunIdentityEnvService>;

package/dist/src/run-identity.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/run-identity.ts
+var RUN_IDENTITY_ENV_CAPABILITY_ID = "cap:run-identity-env";
+var RUN_IDENTITY_ENV = makeCapabilityId(RUN_IDENTITY_ENV_CAPABILITY_ID);
+export {
+  RUN_IDENTITY_ENV_CAPABILITY_ID,
+  RUN_IDENTITY_ENV
+};

package/dist/src/run-journal.d.ts

@@ -635,241 +635,6 @@ export declare const RunJournalEvent: Schema.Union<readonly [Schema.Struct<{
     readonly runId: Schema.brand<Schema.Trim, "RunId">;
 }>]>;
 export type RunJournalEvent = typeof RunJournalEvent.Type;
-export declare const decodeRunJournalEvent: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "status-changed";
-    readonly from: "running" | "stopped" | "completed" | "created" | "queued" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention" | "failed" | null;
-    readonly to: "running" | "stopped" | "completed" | "created" | "queued" | "preparing" | "waiting-approval" | "waiting-user-input" | "paused" | "validating" | "reviewing" | "closing-out" | "needs-attention" | "failed";
-    readonly seq: number;
-    readonly reason?: string | null | undefined;
-    readonly actor?: {
-        readonly kind: "server" | "system" | "agent" | "operator";
-        readonly id?: string | null | undefined;
-    } | undefined;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "record-patch";
-    readonly seq: number;
-    readonly patch: {
-        readonly taskId?: string | null | undefined;
-        readonly runId?: string | undefined;
-        readonly createdAt?: string | undefined;
-        readonly title?: string | undefined;
-        readonly mode?: "local" | "remote" | undefined;
-        readonly startedAt?: string | null | undefined;
-        readonly updatedAt?: string | undefined;
-        readonly runtimeMode?: string | null | undefined;
-        readonly threadId?: string | null | undefined;
-        readonly completedAt?: string | null | undefined;
-        readonly interactionMode?: string | null | undefined;
-        readonly branch?: string | null | undefined;
-        readonly worktreePath?: string | null | undefined;
-        readonly model?: string | null | undefined;
-        readonly runtimeAdapter?: "pi" | undefined;
-        readonly initialPrompt?: string | null | undefined;
-        readonly latestMessageId?: string | null | undefined;
-        readonly errorText?: string | null | undefined;
-        readonly workspaceId?: string | undefined;
-        readonly sessionLogPath?: string | null | undefined;
-        readonly pid?: number | null | undefined;
-        readonly prUrl?: string | null | undefined;
-        readonly planning?: unknown;
-        readonly endpointId?: string | null | undefined;
-        readonly hostId?: string | null | undefined;
-        readonly leaseId?: string | null | undefined;
-        readonly runMode?: string | null | undefined;
-        readonly artifactRoot?: string | null | undefined;
-        readonly logRoot?: string | null | undefined;
-        readonly sessionPath?: string | null | undefined;
-        readonly piSession?: unknown;
-        readonly piSessionPrivate?: unknown;
-        readonly projectRoot?: string | null | undefined;
-        readonly serverCloseout?: {
-            readonly status: "running" | "completed" | "pending" | "needs-attention" | "failed";
-            readonly updatedAt: string;
-            readonly phase: "push" | "completed" | "queued" | "merge" | "commit" | "pr-review-merge" | "pr-opened" | "close-source";
-            readonly taskId?: string | null | undefined;
-            readonly reason?: string | null | undefined;
-            readonly error?: string | null | undefined;
-            readonly completedAt?: string | null | undefined;
-            readonly branch?: string | null | undefined;
-            readonly prUrl?: string | null | undefined;
-            readonly merged?: boolean | undefined;
-            readonly runtimeWorkspace?: string | null | undefined;
-            readonly artifactRoot?: string | null | undefined;
-            readonly iterations?: number | null | undefined;
-            readonly feedback?: readonly string[] | undefined;
-            readonly resumedAt?: string | null | undefined;
-        } | null | undefined;
-        readonly baselineMode?: string | null | undefined;
-        readonly prMode?: "auto" | "off" | "ask" | null | undefined;
-        readonly initiatedBy?: string | null | undefined;
-        readonly sourceTask?: unknown;
-        readonly serverPid?: number | null | undefined;
-        readonly latestSteeringAt?: string | null | undefined;
-        readonly latestSteeringDeliveredAt?: string | null | undefined;
-        readonly statusDetail?: string | null | undefined;
-    };
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "timeline-entry";
-    readonly payload: unknown;
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "log-entry";
-    readonly payload: unknown;
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "approval-requested";
-    readonly payload: unknown;
-    readonly requestId: string;
-    readonly requestKind: string;
-    readonly seq: number;
-    readonly actionId?: string | null | undefined;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "approval-resolved";
-    readonly requestId: string;
-    readonly decision: "reject" | "approve";
-    readonly actor: {
-        readonly kind: "server" | "system" | "agent" | "operator";
-        readonly id?: string | null | undefined;
-    };
-    readonly seq: number;
-    readonly note?: string | null | undefined;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "input-requested";
-    readonly payload: unknown;
-    readonly requestId: string;
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "input-resolved";
-    readonly requestId: string;
-    readonly answers: {
-        readonly [x: string]: string;
-    };
-    readonly actor: {
-        readonly kind: "server" | "system" | "agent" | "operator";
-        readonly id?: string | null | undefined;
-    };
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "steering";
-    readonly text: string;
-    readonly actor: {
-        readonly kind: "server" | "system" | "agent" | "operator";
-        readonly id?: string | null | undefined;
-    };
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "adopted";
-    readonly pid: number | null;
-    readonly serverPid: number;
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly detail: string;
-    readonly type: "stall-detected";
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "closeout-phase";
-    readonly phase: "push" | "completed" | "queued" | "merge" | "commit" | "pr-review-merge" | "pr-opened" | "close-source";
-    readonly seq: number;
-    readonly outcome: "completed" | "failed" | "started";
-    readonly detail?: string | null | undefined;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly pipeline: {
-        readonly order: readonly (string & import("effect/Brand").Brand<"StageId">)[];
-        readonly record: readonly {
-            readonly contributedBy: string;
-            readonly stageId: string & import("effect/Brand").Brand<"StageId">;
-            readonly isProtected: boolean;
-            readonly removedBy?: string | undefined;
-            readonly replacedBy?: string | undefined;
-            readonly wrappedBy?: readonly string[] | undefined;
-            readonly droppedAnchors?: readonly (string & import("effect/Brand").Brand<"StageId">)[] | undefined;
-        }[];
-        readonly cycles: readonly (readonly (string & import("effect/Brand").Brand<"StageId">)[])[];
-        readonly runId?: (string & import("effect/Brand").Brand<"RunId">) | undefined;
-        readonly grantUses?: readonly {
-            readonly kind: "kernel-replacement";
-            readonly target: string;
-            readonly pluginId: string;
-        }[] | undefined;
-        readonly resolvedAt?: string | undefined;
-    };
-    readonly type: "pipeline-resolved";
-    readonly seq: number;
-} | {
-    readonly at: string;
-    readonly runId: string & import("effect/Brand").Brand<"RunId">;
-    readonly v: 1;
-    readonly type: "stage-outcome";
-    readonly seq: number;
-    readonly outcome: {
-        readonly stageId: string & import("effect/Brand").Brand<"StageId">;
-        readonly result: {
-            readonly kind: "continue";
-            readonly ctx: {
-                readonly runId: string & import("effect/Brand").Brand<"RunId">;
-                readonly state: unknown;
-                readonly taskId?: (string & import("effect/Brand").Brand<"TaskId">) | null | undefined;
-                readonly metadata?: {
-                    readonly [x: string]: unknown;
-                } | undefined;
-            };
-        } | {
-            readonly kind: "allow";
-        } | {
-            readonly kind: "block";
-            readonly reason: string;
-        };
-        readonly startedAt: string;
-        readonly finishedAt: string;
-    };
-};
-export declare const RUN_STATUS_TRANSITIONS: Readonly<Record<RunStatus, readonly RunStatus[]>>;
-export declare const TERMINAL_RUN_STATUSES: readonly RunStatus[];
-export declare const ACTIVE_RUN_STATUSES: readonly RunStatus[];
-export declare function isTerminalRunStatus(status: RunStatus): boolean;
-export declare function isActiveRunStatus(status: RunStatus): boolean;
-export declare function canTransitionRunStatus(from: RunStatus | null, to: RunStatus): boolean;
-/** Writer-side guard: throws on an illegal transition so bugs fail loudly at the source. */
-export declare function assertRunStatusTransition(from: RunStatus | null, to: RunStatus): void;
 export type RunJournalAnomaly = {
     seq: number;
     kind: "illegal-transition" | "duplicate-resolution" | "unknown-request";
@@ -927,4 +692,3 @@ export type RunJournalProjection = {
     lastEventAt: string | null;
     anomalies: ReadonlyArray<RunJournalAnomaly>;
 };
-export declare function reduceRunJournal(events: ReadonlyArray<RunJournalEvent>, runId?: string | null): RunJournalProjection;