@h-rig/contracts 0.0.6-alpha.18 → 0.0.6-alpha.181

package/dist/src/cli-output.js

@@ -0,0 +1,190 @@
+// @bun
+// packages/contracts/src/cli-output.ts
+import { Schema } from "effect";
+var CLI_OUTPUT_VERSION = 1;
+var RigCliOutputEnvelope = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.String,
+  data: Schema.Unknown
+});
+var CliTaskSummary = Schema.Struct({
+  id: Schema.NullOr(Schema.String),
+  title: Schema.NullOr(Schema.String),
+  status: Schema.NullOr(Schema.String),
+  source: Schema.optional(Schema.String),
+  url: Schema.optional(Schema.String),
+  number: Schema.optional(Schema.Number),
+  labels: Schema.optional(Schema.Array(Schema.Unknown)),
+  assignees: Schema.optional(Schema.Array(Schema.Unknown)),
+  readiness: Schema.optional(Schema.Union([Schema.String, Schema.Boolean])),
+  validators: Schema.optional(Schema.Array(Schema.Unknown)),
+  raw: Schema.optional(Schema.Unknown)
+});
+var CliTaskFilters = Schema.Struct({
+  assignee: Schema.optional(Schema.String),
+  state: Schema.optional(Schema.String),
+  status: Schema.optional(Schema.String),
+  limit: Schema.optional(Schema.Number)
+});
+var CliRunRecord = Schema.Record(Schema.String, Schema.Unknown);
+var CliInboxRecord = Schema.Record(Schema.String, Schema.Unknown);
+var CliDoctorCheck = Schema.Struct({
+  id: Schema.String,
+  label: Schema.String,
+  status: Schema.Literals(["pass", "warn", "fail"]),
+  detail: Schema.optional(Schema.String),
+  remediation: Schema.optional(Schema.String)
+});
+var CliServerConnection = Schema.Union([
+  Schema.Struct({ kind: Schema.Literal("local"), mode: Schema.Literal("auto") }),
+  Schema.Struct({ kind: Schema.Literal("remote"), baseUrl: Schema.String })
+]);
+var CliRepoConnectionState = Schema.Struct({
+  selected: Schema.String,
+  project: Schema.optional(Schema.String),
+  linkedAt: Schema.optional(Schema.String),
+  serverProjectRoot: Schema.optional(Schema.String),
+  serverProjectRootAlias: Schema.optional(Schema.String),
+  serverProjectRootBaseUrl: Schema.optional(Schema.String)
+});
+var CliRemoteProjectLink = Schema.Struct({
+  ok: Schema.Boolean,
+  status: Schema.String,
+  alias: Schema.optional(Schema.String),
+  baseUrl: Schema.optional(Schema.String),
+  repoSlug: Schema.optional(Schema.String),
+  serverProjectRoot: Schema.optional(Schema.String),
+  source: Schema.optional(Schema.String),
+  prepared: Schema.optional(Schema.Boolean),
+  validated: Schema.optional(Schema.Boolean),
+  statusCode: Schema.optional(Schema.Number),
+  message: Schema.String,
+  hint: Schema.String,
+  next: Schema.optional(Schema.String),
+  skippedCandidates: Schema.optional(Schema.Array(Schema.String))
+});
+var RigTaskListOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("task list"),
+  data: Schema.Struct({
+    count: Schema.Number,
+    filters: CliTaskFilters,
+    raw: Schema.Boolean,
+    tasks: Schema.Array(CliTaskSummary)
+  })
+});
+var RigTaskShowOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("task show"),
+  data: Schema.Struct({
+    task: CliTaskSummary,
+    raw: Schema.Boolean
+  })
+});
+var RigRunListOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("run list"),
+  data: Schema.Struct({
+    runs: Schema.Array(CliRunRecord),
+    source: Schema.Literals(["local", "server"])
+  })
+});
+var RigRunShowOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("run show"),
+  data: CliRunRecord
+});
+var RigServerUseOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server use"),
+  data: Schema.Struct({
+    selected: Schema.String,
+    repo: Schema.NullOr(CliRepoConnectionState),
+    remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
+  })
+});
+var RigServerStatusOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server status"),
+  data: Schema.Struct({
+    selected: Schema.String,
+    repo: Schema.NullOr(CliRepoConnectionState),
+    connections: Schema.Record(Schema.String, CliServerConnection),
+    remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
+  })
+});
+var RigServerRepairLinkOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server repair-link"),
+  data: CliRemoteProjectLink
+});
+var RigInboxApprovalsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("inbox approvals"),
+  data: Schema.Struct({
+    approvals: Schema.Array(CliInboxRecord)
+  })
+});
+var RigInboxInputsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("inbox inputs"),
+  data: Schema.Struct({
+    requests: Schema.Array(CliInboxRecord)
+  })
+});
+var RigDoctorCheckOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("doctor check"),
+  data: Schema.Struct({
+    checks: Schema.Array(CliDoctorCheck),
+    failures: Schema.Number
+  })
+});
+var RigStatsData = Schema.Struct({
+  since: Schema.NullOr(Schema.String),
+  totalRuns: Schema.Number,
+  statusCounts: Schema.Record(Schema.String, Schema.Number),
+  completedRuns: Schema.Number,
+  failedRuns: Schema.Number,
+  needsAttentionRuns: Schema.Number,
+  completionRate: Schema.NullOr(Schema.Number),
+  failureRate: Schema.NullOr(Schema.Number),
+  needsAttentionRate: Schema.NullOr(Schema.Number),
+  medianCompletionMs: Schema.NullOr(Schema.Number),
+  steeringTotal: Schema.Number,
+  steeringPerRun: Schema.NullOr(Schema.Number),
+  stallTotal: Schema.Number,
+  approvalsRequested: Schema.Number,
+  approvalsApproved: Schema.Number,
+  approvalsRejected: Schema.Number,
+  approvalsPending: Schema.Number
+});
+var RigStatsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("stats show"),
+  data: RigStatsData
+});
+export {
+  RigTaskShowOutput,
+  RigTaskListOutput,
+  RigStatsOutput,
+  RigStatsData,
+  RigServerUseOutput,
+  RigServerStatusOutput,
+  RigServerRepairLinkOutput,
+  RigRunShowOutput,
+  RigRunListOutput,
+  RigInboxInputsOutput,
+  RigInboxApprovalsOutput,
+  RigDoctorCheckOutput,
+  RigCliOutputEnvelope,
+  CliTaskSummary,
+  CliTaskFilters,
+  CliServerConnection,
+  CliRunRecord,
+  CliRepoConnectionState,
+  CliRemoteProjectLink,
+  CliInboxRecord,
+  CliDoctorCheck,
+  CLI_OUTPUT_VERSION
+};

package/dist/src/cli-runner.d.ts

@@ -0,0 +1,43 @@
+import type { CapabilityId } from "./capability-id";
+import type { CommandExecutionResult, OutputMode } from "./cli-output";
+import type { HarnessEvent, HarnessEventType } from "./harness-events";
+import type { PolicyConfig, PolicyMode } from "./guard";
+export type CliRuntimeInitializeOptions = {
+    readonly projectRoot: string;
+    readonly dryRun: boolean;
+    readonly outputMode: OutputMode;
+    readonly runId?: string;
+    readonly policyMode?: PolicyMode;
+};
+export type CliRuntimeContext = {
+    readonly projectRoot: string;
+    readonly dryRun: boolean;
+    readonly outputMode: OutputMode;
+    readonly runId: string;
+    readonly policyMode?: PolicyMode;
+    readonly eventBus: {
+        getRunId(): string;
+        getEventsFile(): string;
+        getMemoryEvents(): HarnessEvent[];
+        emit<TPayload extends Record<string, unknown>>(type: HarnessEventType, payload: TPayload): Promise<HarnessEvent<TPayload>>;
+    };
+    readonly emitEvent: <TPayload extends Record<string, unknown>>(type: HarnessEventType, payload: TPayload) => Promise<void>;
+    readonly runCommand: (parts: string[]) => Promise<CommandExecutionResult>;
+};
+export type AgentShellMaterializationOptions = {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    readonly moduleDir?: string;
+    readonly build?: (entrypoint: string, output: string, cwd: string, define?: Record<string, string>) => Promise<void>;
+};
+export interface CliRunnerService {
+    initializeRuntime(options: CliRuntimeInitializeOptions): Promise<CliRuntimeContext>;
+    runCommand(context: CliRuntimeContext, parts: string[]): Promise<CommandExecutionResult>;
+    ensureAgentShellBinary(projectRoot: string, options?: AgentShellMaterializationOptions): Promise<string>;
+    resolveAgentMaterializationSourceRoot(projectRoot: string, options?: AgentShellMaterializationOptions): string;
+    withProjectRoot(projectRoot: string): void;
+    formatCommand(parts: string[]): string;
+    loadPolicy(projectRoot: string): PolicyConfig;
+}
+export declare const CLI_RUNNER_CAPABILITY_ID = "rig.cli.runner";
+export declare const CLI_RUNNER: CapabilityId<CliRunnerService>;

package/dist/src/cli-runner.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/cli-runner.ts
+var CLI_RUNNER_CAPABILITY_ID = "rig.cli.runner";
+var CLI_RUNNER = makeCapabilityId(CLI_RUNNER_CAPABILITY_ID);
+export {
+  CLI_RUNNER_CAPABILITY_ID,
+  CLI_RUNNER
+};

package/dist/src/cockpit.d.ts

@@ -0,0 +1,58 @@
+import type { TaskStatus } from "./graph";
+import type { TaskDependencyProjection } from "./task-graph-primitives";
+import type { RigTask } from "./task-source";
+export type RigTaskBadgeProjection = TaskDependencyProjection & {
+    readonly source?: string | null | undefined;
+    readonly url?: string | null | undefined;
+    readonly body?: string | null | undefined;
+    readonly assignedTo?: string | readonly string[] | null | undefined;
+    readonly assignees?: readonly string[] | null | undefined;
+};
+export type TaskProjectionListInput = {
+    readonly tasks?: readonly RigTask[];
+    readonly currentUserLogin?: string | null;
+    readonly nextReadyTaskId?: string | null;
+    readonly assignedToMe?: boolean;
+    readonly limit?: number;
+};
+export type TaskProjectionListRow = {
+    readonly id: string;
+    readonly label: string;
+    readonly currentValue: string;
+    readonly description: string;
+};
+export type TaskProjectionBoardTask = {
+    readonly id: string;
+    readonly status: string;
+    readonly title: string;
+    readonly badge?: string;
+    readonly description?: string;
+};
+export type TaskProjectionStats = {
+    readonly total: number;
+    readonly ready: number;
+    readonly running: number;
+};
+export interface TaskProjectionCapability {
+    normalizeStatus(value: string | null | undefined): TaskStatus;
+    normalizePriority(value: number | string | null | undefined): number | null;
+    project(task: RigTask): RigTaskBadgeProjection;
+    assigneeText(task: RigTask): string;
+    title(task: RigTask | null | undefined): string;
+    id(task: RigTask | null | undefined): string | null;
+    status(task: RigTask | null | undefined): string;
+    description(task: RigTask): string;
+    listRows(input: TaskProjectionListInput): readonly TaskProjectionListRow[];
+    boardTasks(input: TaskProjectionListInput): readonly TaskProjectionBoardTask[];
+    stats(tasks: readonly RigTask[] | undefined): TaskProjectionStats | null;
+}
+export interface DispatchOutcomeCapability {
+    /** Map a raw engine error to a typed operator message, or null to fall back. */
+    humanize(error: unknown): string | null;
+}
+export interface CockpitCapabilities {
+    readonly taskProjection: TaskProjectionCapability;
+    readonly dispatchOutcome: DispatchOutcomeCapability;
+}
+export declare const TASK_PROJECTION_CAPABILITY_ID: import("./capability-id").CapabilityId<TaskProjectionCapability>;
+export declare const DISPATCH_OUTCOME_CAPABILITY_ID: import("./capability-id").CapabilityId<DispatchOutcomeCapability>;

package/dist/src/cockpit.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/cockpit.ts
+var TASK_PROJECTION_CAPABILITY_ID = makeCapabilityId("rig:task-projection");
+var DISPATCH_OUTCOME_CAPABILITY_ID = makeCapabilityId("rig:dispatch-outcome");
+export {
+  TASK_PROJECTION_CAPABILITY_ID,
+  DISPATCH_OUTCOME_CAPABILITY_ID
+};

package/dist/src/collab-session-viewer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pure collab-session-viewer surface vocab.
+ *
+ * The neutral seam for the browser collab-session viewer SPA (the `collab-web`
+ * client, owned by `@rig/collab-session-browser-plugin`). Consumers resolve the
+ * surface off a plugin host without importing the plugin or the SPA. Carries no
+ * behaviour — like `browser.ts` / `notify.ts`.
+ *
+ * The plugin provides the concrete impl (built `dist/` location + the pi-wire
+ * link grammar) under {@link COLLAB_SESSION_VIEWER_CAPABILITY} via the
+ * `defineCapability` seam.
+ */
+import type { CapabilityId } from "./capability-id";
+/** Inputs to format a shareable collab-session viewer link (pi-wire grammar). */
+export interface CollabSessionViewerLinkInput {
+    relayUrl: string;
+    roomId: string;
+    key: Uint8Array;
+    writeToken?: Uint8Array;
+}
+/** Capability id the collab-session-browser plugin registers its surface under. */
+export declare const COLLAB_SESSION_VIEWER_CAPABILITY_ID = "collab.session-viewer";
+/**
+ * The browser collab-session viewer surface. `distDir()` is the built SPA static
+ * root (serve it to hand a browser the live transcript viewer); `formatViewerLink`
+ * preserves the exact `@oh-my-pi/pi-wire` link grammar so a `roomId.key` link
+ * opens the streaming session.
+ */
+export interface CollabSessionViewerSurface {
+    /** Absolute path to the built browser SPA dist directory (static assets). */
+    distDir(): string;
+    /** Format the shareable viewer link using the preserved pi-wire link grammar. */
+    formatViewerLink(input: CollabSessionViewerLinkInput): string;
+}
+/** Typed capability id the plugin provides and consumers require. */
+export declare const COLLAB_SESSION_VIEWER_CAPABILITY: CapabilityId<CollabSessionViewerSurface>;

package/dist/src/collab-session-viewer.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/collab-session-viewer.ts
+var COLLAB_SESSION_VIEWER_CAPABILITY_ID = "collab.session-viewer";
+var COLLAB_SESSION_VIEWER_CAPABILITY = makeCapabilityId(COLLAB_SESSION_VIEWER_CAPABILITY_ID);
+export {
+  COLLAB_SESSION_VIEWER_CAPABILITY_ID,
+  COLLAB_SESSION_VIEWER_CAPABILITY
+};