@h-rig/contracts 0.0.6-alpha.14 → 0.0.6-alpha.140

package/dist/src/task-source.d.ts

@@ -0,0 +1,37 @@
+import type { TaskSourceRegistration } from "./plugin";
+/**
+ * A single task record returned by a task source adapter.
+ * Open-ended to allow adapters to include source-specific fields.
+ */
+export interface TaskRecord {
+    id: string;
+    deps: readonly string[];
+    status: "ready" | "in_progress" | "closed" | "blocked" | "open" | string;
+    [extra: string]: unknown;
+}
+/**
+ * A registered task source adapter — combines the plugin-level registration
+ * metadata with the runtime-callable interface.
+ */
+export interface TaskSourceUpdate {
+    status?: TaskRecord["status"];
+    title?: string;
+    body?: string;
+    comment?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskSourceCreateInput {
+    title: string;
+    body: string;
+    deps?: readonly string[];
+    parents?: readonly string[];
+    metadata?: Record<string, unknown>;
+}
+export type TaskSourceCreateResult = TaskRecord;
+export interface RegisteredTaskSource extends TaskSourceRegistration {
+    list(): Promise<readonly TaskRecord[]>;
+    get?(id: string): Promise<TaskRecord | undefined>;
+    updateStatus?(id: string, status: TaskRecord["status"]): Promise<void>;
+    updateTask?(id: string, update: TaskSourceUpdate): Promise<void>;
+    create?(input: TaskSourceCreateInput): Promise<TaskSourceCreateResult>;
+}

package/dist/src/terminal.d.ts

@@ -0,0 +1,130 @@
+import { Schema } from "effect";
+export declare const DEFAULT_TERMINAL_ID = "default";
+export declare const TerminalThreadInput: Schema.Struct<{
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalThreadInput = Schema.Codec.Encoded<typeof TerminalThreadInput>;
+declare const TerminalSessionInput: Schema.Struct<{
+    readonly terminalId: Schema.withDecodingDefault<Schema.Trim>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalSessionInput = Schema.Codec.Encoded<typeof TerminalSessionInput>;
+export declare const TerminalOpenInput: Schema.Struct<{
+    readonly cwd: Schema.Trim;
+    readonly cols: Schema.optional<Schema.Int>;
+    readonly rows: Schema.optional<Schema.Int>;
+    readonly env: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly terminalId: Schema.withDecodingDefault<Schema.Trim>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalOpenInput = Schema.Codec.Encoded<typeof TerminalOpenInput>;
+export declare const TerminalWriteInput: Schema.Struct<{
+    readonly data: Schema.String;
+    readonly terminalId: Schema.withDecodingDefault<Schema.Trim>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalWriteInput = Schema.Codec.Encoded<typeof TerminalWriteInput>;
+export declare const TerminalResizeInput: Schema.Struct<{
+    readonly cols: Schema.Int;
+    readonly rows: Schema.Int;
+    readonly terminalId: Schema.withDecodingDefault<Schema.Trim>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalResizeInput = Schema.Codec.Encoded<typeof TerminalResizeInput>;
+export declare const TerminalClearInput: Schema.Struct<{
+    readonly terminalId: Schema.withDecodingDefault<Schema.Trim>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalClearInput = Schema.Codec.Encoded<typeof TerminalClearInput>;
+export declare const TerminalRestartInput: Schema.Struct<{
+    readonly cwd: Schema.Trim;
+    readonly cols: Schema.Int;
+    readonly rows: Schema.Int;
+    readonly env: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly threadId: Schema.Trim;
+}>;
+export declare const TerminalCloseInput: Schema.Struct<{
+    readonly terminalId: Schema.optional<Schema.Trim>;
+    readonly deleteHistory: Schema.optional<Schema.Boolean>;
+    readonly threadId: Schema.Trim;
+}>;
+export type TerminalCloseInput = Schema.Codec.Encoded<typeof TerminalCloseInput>;
+export declare const TerminalSessionStatus: Schema.Literals<readonly ["starting", "running", "exited", "error"]>;
+export type TerminalSessionStatus = typeof TerminalSessionStatus.Type;
+export declare const TerminalSessionSnapshot: Schema.Struct<{
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly cwd: Schema.String;
+    readonly status: Schema.Literals<readonly ["starting", "running", "exited", "error"]>;
+    readonly pid: Schema.NullOr<Schema.Int>;
+    readonly history: Schema.String;
+    readonly exitCode: Schema.NullOr<Schema.Int>;
+    readonly exitSignal: Schema.NullOr<Schema.String>;
+    readonly updatedAt: Schema.String;
+}>;
+export type TerminalSessionSnapshot = typeof TerminalSessionSnapshot.Type;
+export declare const TerminalEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"started">;
+    readonly snapshot: Schema.Struct<{
+        readonly threadId: Schema.String;
+        readonly terminalId: Schema.String;
+        readonly cwd: Schema.String;
+        readonly status: Schema.Literals<readonly ["starting", "running", "exited", "error"]>;
+        readonly pid: Schema.NullOr<Schema.Int>;
+        readonly history: Schema.String;
+        readonly exitCode: Schema.NullOr<Schema.Int>;
+        readonly exitSignal: Schema.NullOr<Schema.String>;
+        readonly updatedAt: Schema.String;
+    }>;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"output">;
+    readonly data: Schema.String;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"exited">;
+    readonly exitCode: Schema.NullOr<Schema.Int>;
+    readonly exitSignal: Schema.NullOr<Schema.String>;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"error">;
+    readonly message: Schema.String;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"cleared">;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"restarted">;
+    readonly snapshot: Schema.Struct<{
+        readonly threadId: Schema.String;
+        readonly terminalId: Schema.String;
+        readonly cwd: Schema.String;
+        readonly status: Schema.Literals<readonly ["starting", "running", "exited", "error"]>;
+        readonly pid: Schema.NullOr<Schema.Int>;
+        readonly history: Schema.String;
+        readonly exitCode: Schema.NullOr<Schema.Int>;
+        readonly exitSignal: Schema.NullOr<Schema.String>;
+        readonly updatedAt: Schema.String;
+    }>;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"activity">;
+    readonly hasRunningSubprocess: Schema.Boolean;
+    readonly threadId: Schema.String;
+    readonly terminalId: Schema.String;
+    readonly createdAt: Schema.String;
+}>]>;
+export type TerminalEvent = typeof TerminalEvent.Type;
+export {};

package/dist/src/terminal.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

package/dist/src/validation.d.ts

@@ -0,0 +1,14 @@
+import { Schema } from "effect";
+export declare const ValidationStatus: Schema.Literals<readonly ["pending", "running", "passed", "failed", "skipped"]>;
+export type ValidationStatus = typeof ValidationStatus.Type;
+export declare const ValidationSummary: Schema.Struct<{
+    readonly id: Schema.brand<Schema.Trim, "ValidationResultId">;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly taskId: Schema.NullOr<Schema.brand<Schema.Trim, "TaskId">>;
+    readonly validatorKey: Schema.Trim;
+    readonly status: Schema.Literals<readonly ["pending", "running", "passed", "failed", "skipped"]>;
+    readonly output: Schema.Unknown;
+    readonly startedAt: Schema.String;
+    readonly completedAt: Schema.NullOr<Schema.String>;
+}>;
+export type ValidationSummary = typeof ValidationSummary.Type;

package/dist/src/validation.js

@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
 var GraphId = makeEntityId("GraphId");
 var TaskId = makeEntityId("TaskId");
 var RunId = makeEntityId("RunId");
+var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
+var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
+var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
 var EngineRuntimeId = makeEntityId("EngineRuntimeId");
 var ConversationId = makeEntityId("ConversationId");
 var ActionId = makeEntityId("ActionId");

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

@@ -0,0 +1,124 @@
+export declare const RIG_WORKFLOW_STARTED: "rig.workflow.started";
+export declare const RIG_WORKFLOW_TARGET_SELECTED: "rig.workflow.target.selected";
+export declare const RIG_WORKFLOW_TASK_SELECTED: "rig.workflow.task.selected";
+export declare const RIG_WORKFLOW_STATUS_CHANGED: "rig.workflow.status.changed";
+export declare const RIG_WORKFLOW_OPERATOR_NOTE: "rig.workflow.operator.note";
+export declare const RIG_WORKFLOW_INBOX_REQUESTED: "rig.workflow.inbox.requested";
+export declare const RIG_WORKFLOW_INBOX_RESOLVED: "rig.workflow.inbox.resolved";
+export type RigWorkflowEntryType = typeof RIG_WORKFLOW_STARTED | typeof RIG_WORKFLOW_TARGET_SELECTED | typeof RIG_WORKFLOW_TASK_SELECTED | typeof RIG_WORKFLOW_STATUS_CHANGED | typeof RIG_WORKFLOW_OPERATOR_NOTE | typeof RIG_WORKFLOW_INBOX_REQUESTED | typeof RIG_WORKFLOW_INBOX_RESOLVED;
+export type RigWorkflowTarget = "local" | "remote";
+export type RigWorkflowOwner = {
+    githubUserId: string;
+    login: string;
+    namespaceKey: string;
+};
+export type RigWorkflowStarted = {
+    schemaVersion: 1;
+    workflowId: string;
+    target: RigWorkflowTarget;
+    selectedRepo: string;
+    owner: RigWorkflowOwner;
+    createdAt: string;
+};
+export type RigWorkflowTargetSelected = {
+    schemaVersion: 1;
+    target: RigWorkflowTarget;
+    reason?: string;
+    selectedAt: string;
+};
+export type RigWorkflowTaskSelected = {
+    schemaVersion: 1;
+    taskId: string;
+    title?: string;
+    selectedAt: string;
+};
+export type RigWorkflowStatus = "starting" | "running" | "waiting-approval" | "waiting-input" | "completed" | "failed" | "stopped";
+export type RigWorkflowStatusChanged = {
+    schemaVersion: 1;
+    status: RigWorkflowStatus;
+    detail?: string;
+    changedAt: string;
+};
+export type RigWorkflowOperatorNote = {
+    schemaVersion: 1;
+    noteId?: string;
+    note: string;
+    notedAt: string;
+};
+export type RigWorkflowInboxRequested = {
+    schemaVersion: 1;
+    requestId: string;
+    kind: "approval" | "input";
+    title: string;
+    body?: string;
+    options?: readonly string[];
+    requestedAt: string;
+};
+export type RigWorkflowInboxResolved = {
+    schemaVersion: 1;
+    requestId: string;
+    decision: "approved" | "rejected" | "answered";
+    answer?: unknown;
+    resolvedAt: string;
+};
+export type RigWorkflowProjection = {
+    started: RigWorkflowStarted | null;
+    target: RigWorkflowTargetSelected | null;
+    task: RigWorkflowTaskSelected | null;
+    status: RigWorkflowStatusChanged | null;
+    notes: readonly RigWorkflowOperatorNote[];
+    inbox: readonly RigWorkflowInboxRequested[];
+    resolvedInbox: readonly RigWorkflowInboxResolved[];
+    updatedAt: string | null;
+};
+export type RigWorkflowCustomEntry = {
+    type: string;
+    customType?: string;
+    data?: unknown;
+};
+export declare function createWorkflowStarted(input: Omit<RigWorkflowStarted, "schemaVersion" | "createdAt"> & {
+    createdAt?: string;
+}): RigWorkflowStarted;
+export declare function createWorkflowTargetSelected(input: Omit<RigWorkflowTargetSelected, "schemaVersion" | "selectedAt"> & {
+    selectedAt?: string;
+}): RigWorkflowTargetSelected;
+export declare function createWorkflowTaskSelected(input: Omit<RigWorkflowTaskSelected, "schemaVersion" | "selectedAt"> & {
+    selectedAt?: string;
+}): RigWorkflowTaskSelected;
+export declare function createWorkflowStatusChanged(input: Omit<RigWorkflowStatusChanged, "schemaVersion" | "changedAt"> & {
+    changedAt?: string;
+}): RigWorkflowStatusChanged;
+export declare function createWorkflowOperatorNote(input: Omit<RigWorkflowOperatorNote, "schemaVersion" | "notedAt"> & {
+    notedAt?: string;
+}): RigWorkflowOperatorNote;
+export declare function createWorkflowInboxRequested(input: Omit<RigWorkflowInboxRequested, "schemaVersion" | "requestedAt"> & {
+    requestedAt?: string;
+}): RigWorkflowInboxRequested;
+export declare function createWorkflowInboxResolved(input: Omit<RigWorkflowInboxResolved, "schemaVersion" | "resolvedAt"> & {
+    resolvedAt?: string;
+}): RigWorkflowInboxResolved;
+export declare function parseWorkflowStarted(data: unknown): RigWorkflowStarted | null;
+export declare function parseWorkflowTargetSelected(data: unknown): RigWorkflowTargetSelected | null;
+export declare function parseWorkflowTaskSelected(data: unknown): RigWorkflowTaskSelected | null;
+export declare function parseWorkflowStatusChanged(data: unknown): RigWorkflowStatusChanged | null;
+export declare function parseWorkflowOperatorNote(data: unknown): RigWorkflowOperatorNote | null;
+export declare function parseWorkflowInboxRequested(data: unknown): RigWorkflowInboxRequested | null;
+export declare function parseWorkflowInboxResolved(data: unknown): RigWorkflowInboxResolved | null;
+export declare function collectPendingInboxRequests(entries: readonly RigWorkflowCustomEntry[]): RigWorkflowInboxRequested[];
+export declare function collectResolvedInboxRequests(entries: readonly RigWorkflowCustomEntry[]): RigWorkflowInboxResolved[];
+export type RigCollabWorkflowMarkerInput = {
+    sessionId: string;
+    sessionPath: string;
+    cwd: string;
+    title: string;
+    joinLink: string;
+    webLink: string;
+    relayUrl?: string;
+    selectedRepo?: string;
+    owner?: Partial<RigWorkflowOwner>;
+    startedAt: string;
+    updatedAt: string;
+    stale: boolean;
+};
+export declare function projectCollabWorkflowMarker(collab: RigCollabWorkflowMarkerInput): RigWorkflowProjection;
+export declare function projectWorkflowEntries(entries: readonly RigWorkflowCustomEntry[]): RigWorkflowProjection;