@h-rig/contracts 0.0.6-alpha.16 → 0.0.6-alpha.160

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/dist/index.cjs +3280 -0
  2. package/dist/index.mjs +3239 -0
  3. package/dist/src/agent-roles.d.ts +8 -0
  4. package/dist/src/artifact.d.ts +13 -0
  5. package/dist/src/artifact.js +3 -0
  6. package/dist/src/baseSchemas.d.ts +63 -0
  7. package/dist/src/baseSchemas.js +6 -0
  8. package/dist/src/browser.d.ts +80 -0
  9. package/dist/src/browser.js +13 -0
  10. package/dist/src/capability-id.d.ts +22 -0
  11. package/dist/src/capability-id.js +8 -0
  12. package/dist/src/cli-output.d.ts +348 -0
  13. package/dist/src/cli-output.js +190 -0
  14. package/dist/src/cli-runner.d.ts +43 -0
  15. package/dist/src/cli-runner.js +13 -0
  16. package/dist/src/collab-session-viewer.d.ts +36 -0
  17. package/dist/src/collab-session-viewer.js +13 -0
  18. package/dist/src/config.d.ts +551 -0
  19. package/dist/src/config.js +765 -162
  20. package/dist/src/control-plane-types.d.ts +323 -0
  21. package/dist/src/control-plane-types.js +13 -0
  22. package/dist/src/conversation.d.ts +50 -0
  23. package/dist/src/conversation.js +3 -0
  24. package/dist/src/dependency-preflight.d.ts +43 -0
  25. package/dist/src/dependency-preflight.js +13 -0
  26. package/dist/src/doctor.d.ts +90 -0
  27. package/dist/src/doctor.js +13 -0
  28. package/dist/src/drift.d.ts +28 -0
  29. package/dist/src/drift.js +69 -0
  30. package/dist/src/editor.d.ts +25 -0
  31. package/dist/src/editor.js +3 -0
  32. package/dist/src/errors.d.ts +13 -0
  33. package/dist/src/errors.js +17 -0
  34. package/dist/src/git.d.ts +144 -0
  35. package/dist/src/git.js +3 -0
  36. package/dist/src/github.d.ts +146 -0
  37. package/dist/src/github.js +17 -0
  38. package/dist/src/graph.d.ts +360 -0
  39. package/dist/src/graph.js +137 -1
  40. package/dist/src/guard.d.ts +111 -0
  41. package/dist/src/guard.js +6 -0
  42. package/dist/src/harness-events.d.ts +8 -0
  43. package/dist/src/harness-events.js +1 -0
  44. package/dist/src/help-catalog.d.ts +41 -0
  45. package/dist/src/help-catalog.js +13 -0
  46. package/dist/src/host.d.ts +41 -0
  47. package/dist/src/host.js +13 -0
  48. package/dist/src/identity.d.ts +44 -0
  49. package/dist/src/identity.js +1 -0
  50. package/dist/src/index.d.ts +77 -0
  51. package/dist/src/index.js +2661 -3970
  52. package/dist/src/isolation.d.ts +213 -0
  53. package/dist/src/isolation.js +13 -0
  54. package/dist/src/kernel.d.ts +200 -0
  55. package/dist/src/kernel.js +261 -0
  56. package/dist/src/keybindings.d.ts +71 -0
  57. package/dist/src/keybindings.js +3 -0
  58. package/dist/src/layout.d.ts +49 -0
  59. package/dist/src/layout.js +10 -0
  60. package/dist/src/lifecycle-capabilities.d.ts +128 -0
  61. package/dist/src/lifecycle-capabilities.js +25 -0
  62. package/dist/src/managed-repos.d.ts +136 -0
  63. package/dist/src/managed-repos.js +17 -0
  64. package/dist/src/memory.d.ts +199 -0
  65. package/dist/src/memory.js +15 -0
  66. package/dist/src/model.d.ts +77 -0
  67. package/dist/src/notify.d.ts +46 -0
  68. package/dist/src/notify.js +13 -0
  69. package/dist/src/orchestration.d.ts +43 -0
  70. package/dist/src/orchestration.js +28 -961
  71. package/dist/src/panel-protocol.d.ts +17 -0
  72. package/dist/src/panel-protocol.js +10 -0
  73. package/dist/src/pi-session.d.ts +113 -0
  74. package/dist/src/pi-session.js +1 -0
  75. package/dist/src/planning.d.ts +64 -0
  76. package/dist/src/planning.js +90 -0
  77. package/dist/src/plugin-hooks.d.ts +51 -0
  78. package/dist/src/plugin-hooks.js +386 -0
  79. package/dist/src/plugin.d.ts +476 -0
  80. package/dist/src/plugin.js +346 -64
  81. package/dist/src/policy.d.ts +16 -0
  82. package/dist/src/policy.js +3 -0
  83. package/dist/src/project.d.ts +71 -0
  84. package/dist/src/project.js +3 -0
  85. package/dist/src/prompt.d.ts +29 -0
  86. package/dist/src/prompt.js +13 -0
  87. package/dist/src/protocol-version.d.ts +21 -0
  88. package/dist/src/protocol-version.js +6 -0
  89. package/dist/src/provider-instructions.d.ts +41 -0
  90. package/dist/src/provider-instructions.js +13 -0
  91. package/dist/src/provider.d.ts +105 -0
  92. package/dist/src/provider.js +4 -824
  93. package/dist/src/remote.d.ts +318 -0
  94. package/dist/src/remote.js +238 -1078
  95. package/dist/src/review.d.ts +18 -0
  96. package/dist/src/review.js +3 -0
  97. package/dist/src/rollups.d.ts +41 -0
  98. package/dist/src/rollups.js +70 -0
  99. package/dist/src/run-discovery.d.ts +79 -0
  100. package/dist/src/run-discovery.js +13 -0
  101. package/dist/src/run-dispatch.d.ts +34 -0
  102. package/dist/src/run-dispatch.js +13 -0
  103. package/dist/src/run-identity.d.ts +47 -0
  104. package/dist/src/run-identity.js +13 -0
  105. package/dist/src/run-journal.d.ts +694 -0
  106. package/dist/src/run-journal.js +569 -0
  107. package/dist/src/run-read-model.d.ts +234 -0
  108. package/dist/src/run-read-model.js +13 -0
  109. package/dist/src/run-record.d.ts +45 -0
  110. package/dist/src/run-record.js +1 -0
  111. package/dist/src/run-registry-backbone.d.ts +56 -0
  112. package/dist/src/run-registry-backbone.js +13 -0
  113. package/dist/src/run-session-journal.d.ts +69 -0
  114. package/dist/src/run-session-journal.js +78 -0
  115. package/dist/src/run-status.d.ts +10 -0
  116. package/dist/src/run-status.js +27 -0
  117. package/dist/src/run-timeline.d.ts +7 -0
  118. package/dist/src/run-timeline.js +1 -0
  119. package/dist/src/runtime-task-context.d.ts +82 -0
  120. package/dist/src/runtime-task-context.js +1 -0
  121. package/dist/src/runtime.d.ts +103 -0
  122. package/dist/src/runtime.js +73 -906
  123. package/dist/src/session-asset-materializer.d.ts +35 -0
  124. package/dist/src/session-asset-materializer.js +13 -0
  125. package/dist/src/setup.d.ts +47 -0
  126. package/dist/src/setup.js +13 -0
  127. package/dist/src/stage.d.ts +245 -0
  128. package/dist/src/stage.js +169 -0
  129. package/dist/src/supervisor-journal.d.ts +204 -0
  130. package/dist/src/supervisor-journal.js +334 -0
  131. package/dist/src/task-data.d.ts +239 -0
  132. package/dist/src/task-data.js +13 -0
  133. package/dist/src/task-graph-primitives.d.ts +47 -0
  134. package/dist/src/task-graph-primitives.js +1 -0
  135. package/dist/src/task-source.d.ts +102 -0
  136. package/dist/src/task-source.js +12 -0
  137. package/dist/src/task-state-metadata.d.ts +21 -0
  138. package/dist/src/task-state-metadata.js +1 -0
  139. package/dist/src/terminal.d.ts +130 -0
  140. package/dist/src/terminal.js +3 -0
  141. package/dist/src/tool-materializer.d.ts +36 -0
  142. package/dist/src/tool-materializer.js +13 -0
  143. package/dist/src/tool-registry.d.ts +3 -0
  144. package/dist/src/tool-registry.js +58 -0
  145. package/dist/src/toolchain-sources.d.ts +54 -0
  146. package/dist/src/toolchain-sources.js +17 -0
  147. package/dist/src/validation.d.ts +14 -0
  148. package/dist/src/validation.js +3 -0
  149. package/dist/src/workflow-journal.d.ts +92 -0
  150. package/dist/src/workflow-journal.js +18 -0
  151. package/dist/src/workspace-config.d.ts +18 -0
  152. package/dist/src/workspace-config.js +13 -0
  153. package/dist/src/workspace.d.ts +204 -0
  154. package/dist/src/workspace.js +76 -911
  155. package/package.json +51 -4
  156. package/dist/src/engine.js +0 -2278
  157. package/dist/src/providerRuntime.js +0 -1630
  158. package/dist/src/rig.js +0 -2374
  159. package/dist/src/server.js +0 -1053
  160. package/dist/src/serviceFabric.js +0 -1066
  161. package/dist/src/ws.js +0 -2968
  162. /package/dist/src/{ipc.js → agent-roles.js} +0 -0
@@ -0,0 +1,77 @@
1
+ import { Schema } from "effect";
2
+ import { ProviderKind } from "./orchestration";
3
+ export declare const CODEX_REASONING_EFFORT_OPTIONS: readonly ["xhigh", "high", "medium", "low"];
4
+ export type CodexReasoningEffort = (typeof CODEX_REASONING_EFFORT_OPTIONS)[number];
5
+ export declare const CodexModelOptions: Schema.Struct<{
6
+ readonly reasoningEffort: Schema.optional<Schema.Literals<readonly ["xhigh", "high", "medium", "low"]>>;
7
+ readonly fastMode: Schema.optional<Schema.Boolean>;
8
+ }>;
9
+ export type CodexModelOptions = typeof CodexModelOptions.Type;
10
+ export declare const ClaudeModelOptions: Schema.Struct<{}>;
11
+ export type ClaudeModelOptions = typeof ClaudeModelOptions.Type;
12
+ export declare const ProviderModelOptions: Schema.Struct<{
13
+ readonly codex: Schema.optional<Schema.Struct<{
14
+ readonly reasoningEffort: Schema.optional<Schema.Literals<readonly ["xhigh", "high", "medium", "low"]>>;
15
+ readonly fastMode: Schema.optional<Schema.Boolean>;
16
+ }>>;
17
+ readonly claude: Schema.optional<Schema.Struct<{}>>;
18
+ }>;
19
+ export type ProviderModelOptions = typeof ProviderModelOptions.Type;
20
+ export declare const MODEL_OPTIONS_BY_PROVIDER: {
21
+ readonly codex: readonly [{
22
+ readonly slug: "gpt-5.4";
23
+ readonly name: "GPT-5.4";
24
+ }, {
25
+ readonly slug: "gpt-5.3-codex";
26
+ readonly name: "GPT-5.3 Codex";
27
+ }, {
28
+ readonly slug: "gpt-5.3-codex-spark";
29
+ readonly name: "GPT-5.3 Codex Spark";
30
+ }, {
31
+ readonly slug: "gpt-5.2-codex";
32
+ readonly name: "GPT-5.2 Codex";
33
+ }, {
34
+ readonly slug: "gpt-5.2";
35
+ readonly name: "GPT-5.2";
36
+ }];
37
+ readonly claude: readonly [{
38
+ readonly slug: "claude-sonnet-4-6";
39
+ readonly name: "Claude Sonnet 4.6";
40
+ }, {
41
+ readonly slug: "claude-opus-4-1";
42
+ readonly name: "Claude Opus 4.1";
43
+ }, {
44
+ readonly slug: "claude-3-7-sonnet-latest";
45
+ readonly name: "Claude 3.7 Sonnet";
46
+ }];
47
+ };
48
+ export type ModelOptionsByProvider = typeof MODEL_OPTIONS_BY_PROVIDER;
49
+ type BuiltInModelSlug = ModelOptionsByProvider[ProviderKind][number]["slug"];
50
+ export type ModelSlug = BuiltInModelSlug | (string & {});
51
+ export declare const DEFAULT_MODEL_BY_PROVIDER: {
52
+ readonly codex: "gpt-5.4";
53
+ readonly claude: "claude-sonnet-4-6";
54
+ };
55
+ export declare const MODEL_SLUG_ALIASES_BY_PROVIDER: {
56
+ readonly codex: {
57
+ readonly "5.4": "gpt-5.4";
58
+ readonly "5.3": "gpt-5.3-codex";
59
+ readonly "gpt-5.3": "gpt-5.3-codex";
60
+ readonly "5.3-spark": "gpt-5.3-codex-spark";
61
+ readonly "gpt-5.3-spark": "gpt-5.3-codex-spark";
62
+ };
63
+ readonly claude: {
64
+ readonly sonnet: "claude-sonnet-4-6";
65
+ readonly opus: "claude-opus-4-1";
66
+ readonly "3.7-sonnet": "claude-3-7-sonnet-latest";
67
+ };
68
+ };
69
+ export declare const REASONING_EFFORT_OPTIONS_BY_PROVIDER: {
70
+ readonly codex: readonly ["xhigh", "high", "medium", "low"];
71
+ readonly claude: readonly [];
72
+ };
73
+ export declare const DEFAULT_REASONING_EFFORT_BY_PROVIDER: {
74
+ readonly codex: "high";
75
+ readonly claude: null;
76
+ };
77
+ export {};
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Pure NOTIFY capability vocab.
3
+ *
4
+ * The neutral home for the notification event/target data types and the typed
5
+ * capability seam so the floor (and any consumer) can resolve a notifier off a
6
+ * plugin host WITHOUT importing the provider package. Carries no behaviour —
7
+ * exactly like `browser.ts` / `memory.ts`.
8
+ *
9
+ * `@rig/notifications-plugin` provides the concrete `NotifyService` impl
10
+ * (config load + target selection = policy) under
11
+ * {@link NOTIFY_SERVICE_CAPABILITY} via the `defineCapability` seam.
12
+ */
13
+ import type { CapabilityId } from "./capability-id";
14
+ /** A Rig lifecycle event eligible for outbound notification. */
15
+ export type RigEvent = {
16
+ id?: string;
17
+ runId?: string;
18
+ timestamp?: string;
19
+ type: string;
20
+ payload?: Record<string, unknown>;
21
+ };
22
+ /** A configured outbound notification channel. */
23
+ export type NotificationTarget = {
24
+ id: string;
25
+ type: "slack-webhook" | "linear-webhook" | "notion-webhook" | "generic-webhook";
26
+ url: string;
27
+ enabled?: boolean;
28
+ events?: string[];
29
+ headers?: Record<string, string>;
30
+ };
31
+ /** The on-disk notification policy (`.rig/notifications.json`). */
32
+ export type NotificationConfig = {
33
+ targets: NotificationTarget[];
34
+ };
35
+ /** Capability id the notifications plugin registers its `NotifyService` under. */
36
+ export declare const NOTIFY_SERVICE_CAPABILITY_ID = "notify.dispatch";
37
+ /**
38
+ * The cohesive notify operation consumers depend on. The impl owns the policy:
39
+ * which targets receive which events, loaded from the project's
40
+ * `.rig/notifications.json`. Returns the count of targets successfully notified.
41
+ */
42
+ export interface NotifyService {
43
+ notify(event: RigEvent): Promise<number>;
44
+ }
45
+ /** Typed capability id the notifications plugin provides and consumers require. */
46
+ export declare const NOTIFY_SERVICE_CAPABILITY: CapabilityId<NotifyService>;
@@ -0,0 +1,13 @@
1
+ // @bun
2
+ // packages/contracts/src/capability-id.ts
3
+ function makeCapabilityId(id) {
4
+ return id;
5
+ }
6
+
7
+ // packages/contracts/src/notify.ts
8
+ var NOTIFY_SERVICE_CAPABILITY_ID = "notify.dispatch";
9
+ var NOTIFY_SERVICE_CAPABILITY = makeCapabilityId(NOTIFY_SERVICE_CAPABILITY_ID);
10
+ export {
11
+ NOTIFY_SERVICE_CAPABILITY_ID,
12
+ NOTIFY_SERVICE_CAPABILITY
13
+ };
@@ -0,0 +1,43 @@
1
+ import { Schema } from "effect";
2
+ export declare const ProviderKind: Schema.Literals<readonly ["codex", "claude"]>;
3
+ export type ProviderKind = typeof ProviderKind.Type;
4
+ export declare const ProviderApprovalPolicy: Schema.Literals<readonly ["untrusted", "on-failure", "on-request", "never"]>;
5
+ export type ProviderApprovalPolicy = typeof ProviderApprovalPolicy.Type;
6
+ export declare const ProviderSandboxMode: Schema.Literals<readonly ["read-only", "workspace-write", "danger-full-access"]>;
7
+ export type ProviderSandboxMode = typeof ProviderSandboxMode.Type;
8
+ export declare const ProviderServiceTier: Schema.Literals<readonly ["fast", "flex"]>;
9
+ export type ProviderServiceTier = typeof ProviderServiceTier.Type;
10
+ export declare const RuntimeMode: Schema.Literals<readonly ["approval-required", "full-access"]>;
11
+ export type RuntimeMode = typeof RuntimeMode.Type;
12
+ export declare const DEFAULT_RUNTIME_MODE: RuntimeMode;
13
+ export declare const ProviderInteractionMode: Schema.Literals<readonly ["default", "plan"]>;
14
+ export type ProviderInteractionMode = typeof ProviderInteractionMode.Type;
15
+ export declare const DEFAULT_PROVIDER_INTERACTION_MODE: ProviderInteractionMode;
16
+ export declare const ProviderRequestKind: Schema.Literals<readonly ["command", "file-read", "file-change"]>;
17
+ export type ProviderRequestKind = typeof ProviderRequestKind.Type;
18
+ export declare const ProviderApprovalDecision: Schema.Literals<readonly ["accept", "acceptForSession", "decline", "cancel"]>;
19
+ export type ProviderApprovalDecision = typeof ProviderApprovalDecision.Type;
20
+ export declare const ProviderUserInputAnswers: Schema.$Record<Schema.String, Schema.Unknown>;
21
+ export type ProviderUserInputAnswers = typeof ProviderUserInputAnswers.Type;
22
+ export declare const PROVIDER_SEND_TURN_MAX_INPUT_CHARS = 120000;
23
+ export declare const PROVIDER_SEND_TURN_MAX_ATTACHMENTS = 8;
24
+ export declare const PROVIDER_SEND_TURN_MAX_IMAGE_BYTES: number;
25
+ declare const ChatAttachmentId: Schema.Trim;
26
+ export type ChatAttachmentId = typeof ChatAttachmentId.Type;
27
+ export declare const ChatImageAttachment: Schema.Struct<{
28
+ readonly type: Schema.Literal<"image">;
29
+ readonly id: Schema.Trim;
30
+ readonly name: Schema.Trim;
31
+ readonly mimeType: Schema.Trim;
32
+ readonly sizeBytes: Schema.Int;
33
+ }>;
34
+ export type ChatImageAttachment = typeof ChatImageAttachment.Type;
35
+ export declare const ChatAttachment: Schema.Union<readonly [Schema.Struct<{
36
+ readonly type: Schema.Literal<"image">;
37
+ readonly id: Schema.Trim;
38
+ readonly name: Schema.Trim;
39
+ readonly mimeType: Schema.Trim;
40
+ readonly sizeBytes: Schema.Int;
41
+ }>]>;
42
+ export type ChatAttachment = typeof ChatAttachment.Type;
43
+ export {};