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

package/dist/src/runtime-task-context.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Pure runtime-task-context data shapes.
+ *
+ * These are behaviour-free data types describing the per-task runtime context
+ * the substrate materializes and threads to agents and capabilities. They carry
+ * no logic and import nothing but the sibling `RuntimeBrowserContext` contract,
+ * so they belong in the neutral contracts layer (exactly like `memory.ts` /
+ * `lifecycle-capabilities.ts`).
+ *
+ * The fs-backed loaders/serializers that PRODUCE and VALIDATE these shapes stay
+ * in `@rig/runtime/control-plane/runtime/context.ts`, which re-exports these
+ * types for back-compat so existing `import … from ".../runtime/context"` sites
+ * are unaffected.
+ */
+import type { RuntimeBrowserContext } from "./browser";
+/** Retrieval weighting for shared-memory recall; pure config data. */
+export type RuntimeMemoryRetrievalConfig = {
+    topK: number;
+    lexicalWeight: number;
+    vectorWeight: number;
+    recencyWeight: number;
+    confidenceWeight: number;
+};
+/** The materialized shared-memory context handed to a runtime task. */
+export type RuntimeMemoryContext = {
+    canonicalPath: string;
+    canonicalRef: string;
+    canonicalBaseOid?: string;
+    hydratedPath: string;
+    createdFresh: boolean;
+    retrieval: RuntimeMemoryRetrievalConfig;
+};
+/** The source-task contract fields a runtime task carries through. */
+export type RuntimeSourceTaskContract = {
+    id: string;
+    title?: string;
+    description?: string;
+    body?: string;
+    acceptanceCriteria?: string;
+    acceptance_criteria?: string;
+    sourceIssueId?: string;
+    status?: string;
+    issueType?: string;
+    role?: string;
+    externalRef?: string;
+    scope?: string[];
+    validation?: string[];
+    validators?: string[];
+    labels?: string[];
+};
+/** The fully-resolved per-task runtime context. */
+export type RuntimeTaskContext = {
+    runtimeId: string;
+    taskId: string;
+    role: string;
+    scopes: string[];
+    validation: string[];
+    sourceTask?: RuntimeSourceTaskContract;
+    browser?: RuntimeBrowserContext;
+    workspaceDir: string;
+    artifactRoot?: string;
+    hostProjectRoot?: string;
+    monorepoMainRoot?: string;
+    monorepoBaseRef?: string;
+    monorepoBaseCommit?: string;
+    initialHeadCommits?: {
+        project?: string;
+        monorepo?: string;
+    };
+    initialDirtyFiles?: {
+        project?: string[];
+        monorepo?: string[];
+    };
+    stateDir: string;
+    logsDir: string;
+    sessionDir: string;
+    sessionFile: string;
+    policyFile: string;
+    binDir: string;
+    createdAt: string;
+    memory?: RuntimeMemoryContext;
+};

package/dist/src/runtime-task-context.js

@@ -0,0 +1 @@
+// @bun

package/dist/src/runtime.d.ts

@@ -0,0 +1,103 @@
+import { Schema } from "effect";
+export declare const RunKind: Schema.Literals<readonly ["adhoc", "task", "batch", "validation", "review"]>;
+export type RunKind = typeof RunKind.Type;
+export declare const RunMode: Schema.Literals<readonly ["interactive", "autonomous", "supervised"]>;
+export type RunMode = typeof RunMode.Type;
+export declare const RunStatus: Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>;
+export type RunStatus = typeof RunStatus.Type;
+export declare const EngineSandboxMode: Schema.Literals<readonly ["read-only", "workspace-write", "danger-full-access"]>;
+export type EngineSandboxMode = typeof EngineSandboxMode.Type;
+export declare const IsolationMode: Schema.Literals<readonly ["none", "env", "worktree"]>;
+export type IsolationMode = typeof IsolationMode.Type;
+export declare const RuntimeStatus: Schema.Literals<readonly ["prepared", "starting", "running", "interrupted", "exited", "failed", "destroyed"]>;
+export type RuntimeStatus = typeof RuntimeStatus.Type;
+export declare const RunExecutionTarget: Schema.Literals<readonly ["local", "remote"]>;
+export type RunExecutionTarget = typeof RunExecutionTarget.Type;
+export declare const RunSummary: Schema.Struct<{
+    readonly id: Schema.brand<Schema.Trim, "RunId">;
+    readonly workspaceId: Schema.brand<Schema.Trim, "WorkspaceId">;
+    readonly taskId: Schema.NullOr<Schema.brand<Schema.Trim, "TaskId">>;
+    readonly title: Schema.Trim;
+    readonly runKind: Schema.Literals<readonly ["adhoc", "task", "batch", "validation", "review"]>;
+    readonly mode: Schema.Literals<readonly ["interactive", "autonomous", "supervised"]>;
+    readonly runtimeMode: Schema.Literals<readonly ["approval-required", "full-access"]>;
+    readonly interactionMode: Schema.Literals<readonly ["default", "plan"]>;
+    readonly status: Schema.Literals<readonly ["created", "queued", "preparing", "running", "waiting-approval", "waiting-user-input", "paused", "validating", "reviewing", "closing-out", "needs-attention", "completed", "failed", "stopped"]>;
+    readonly runtimeAdapter: Schema.Literal<"pi">;
+    readonly model: Schema.NullOr<Schema.Trim>;
+    readonly initialPrompt: Schema.NullOr<Schema.String>;
+    readonly executionTarget: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
+    readonly remoteHostId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly remoteLeaseId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly remoteLeaseClaimedAt: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly activeRuntimeId: Schema.NullOr<Schema.brand<Schema.Trim, "EngineRuntimeId">>;
+    readonly latestMessageId: Schema.NullOr<Schema.Trim>;
+    readonly pendingApprovalCount: Schema.Int;
+    readonly pendingUserInputCount: Schema.Int;
+    readonly branch: Schema.NullOr<Schema.Trim>;
+    readonly worktreePath: Schema.NullOr<Schema.Trim>;
+    readonly errorText: Schema.NullOr<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+    readonly startedAt: Schema.NullOr<Schema.String>;
+    readonly completedAt: Schema.NullOr<Schema.String>;
+}>;
+export type RunSummary = typeof RunSummary.Type;
+export declare const RuntimeSummary: Schema.Struct<{
+    readonly id: Schema.brand<Schema.Trim, "EngineRuntimeId">;
+    readonly workspaceId: Schema.brand<Schema.Trim, "WorkspaceId">;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly adapterKind: Schema.Literal<"pi">;
+    readonly executionTarget: Schema.optional<Schema.Literals<readonly ["local", "remote"]>>;
+    readonly remoteHostId: Schema.optional<Schema.NullOr<Schema.Trim>>;
+    readonly status: Schema.Literals<readonly ["prepared", "starting", "running", "interrupted", "exited", "failed", "destroyed"]>;
+    readonly sandboxMode: Schema.Literals<readonly ["read-only", "workspace-write", "danger-full-access"]>;
+    readonly isolationMode: Schema.Literals<readonly ["none", "env", "worktree"]>;
+    readonly workspaceDir: Schema.NullOr<Schema.Trim>;
+    readonly homeDir: Schema.NullOr<Schema.Trim>;
+    readonly tmpDir: Schema.NullOr<Schema.Trim>;
+    readonly cacheDir: Schema.NullOr<Schema.Trim>;
+    readonly logsDir: Schema.NullOr<Schema.Trim>;
+    readonly stateDir: Schema.NullOr<Schema.Trim>;
+    readonly sessionDir: Schema.NullOr<Schema.Trim>;
+    readonly sessionLogPath: Schema.NullOr<Schema.Trim>;
+    readonly pid: Schema.NullOr<Schema.Int>;
+    readonly startedAt: Schema.NullOr<Schema.String>;
+    readonly updatedAt: Schema.String;
+    readonly exitedAt: Schema.NullOr<Schema.String>;
+}>;
+export type RuntimeSummary = typeof RuntimeSummary.Type;
+export declare const ApprovalStatus: Schema.Literals<readonly ["pending", "resolved"]>;
+export type ApprovalStatus = typeof ApprovalStatus.Type;
+export declare const ApprovalSummary: Schema.Struct<{
+    readonly id: Schema.Trim;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly actionId: Schema.NullOr<Schema.Trim>;
+    readonly requestKind: Schema.Trim;
+    readonly status: Schema.Literals<readonly ["pending", "resolved"]>;
+    readonly payload: Schema.Unknown;
+    readonly createdAt: Schema.String;
+    readonly resolvedAt: Schema.NullOr<Schema.String>;
+}>;
+export type ApprovalSummary = typeof ApprovalSummary.Type;
+export declare const UserInputRequestSummary: Schema.Struct<{
+    readonly id: Schema.Trim;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly status: Schema.Literals<readonly ["pending", "resolved"]>;
+    readonly payload: Schema.Unknown;
+    readonly createdAt: Schema.String;
+    readonly resolvedAt: Schema.NullOr<Schema.String>;
+}>;
+export type UserInputRequestSummary = typeof UserInputRequestSummary.Type;
+export declare const WorktreeSummary: Schema.Struct<{
+    readonly id: Schema.brand<Schema.Trim, "WorktreeId">;
+    readonly workspaceId: Schema.brand<Schema.Trim, "WorkspaceId">;
+    readonly runId: Schema.brand<Schema.Trim, "RunId">;
+    readonly taskId: Schema.NullOr<Schema.brand<Schema.Trim, "TaskId">>;
+    readonly branchName: Schema.Trim;
+    readonly path: Schema.Trim;
+    readonly status: Schema.Trim;
+    readonly createdAt: Schema.String;
+    readonly cleanedAt: Schema.NullOr<Schema.String>;
+}>;
+export type WorktreeSummary = typeof WorktreeSummary.Type;