@h-rig/contracts 0.0.6-alpha.90 → 0.0.6-alpha.92

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 (42) hide show
  1. package/dist/index.cjs +563 -2
  2. package/dist/index.mjs +565 -2
  3. package/dist/src/artifact.js +3 -0
  4. package/dist/src/baseSchemas.d.ts +6 -0
  5. package/dist/src/baseSchemas.js +6 -0
  6. package/dist/src/cli-output.d.ts +90 -0
  7. package/dist/src/cli-output.js +38 -2
  8. package/dist/src/conversation.js +3 -0
  9. package/dist/src/editor.js +3 -0
  10. package/dist/src/engine.js +3 -0
  11. package/dist/src/git.js +3 -0
  12. package/dist/src/graph.js +3 -0
  13. package/dist/src/help-catalog.d.ts +30 -0
  14. package/dist/src/help-catalog.js +351 -0
  15. package/dist/src/index.d.ts +4 -0
  16. package/dist/src/index.js +565 -2
  17. package/dist/src/ipc.d.ts +2 -1
  18. package/dist/src/keybindings.js +3 -0
  19. package/dist/src/orchestration.js +3 -0
  20. package/dist/src/policy.js +3 -0
  21. package/dist/src/project.js +3 -0
  22. package/dist/src/provider.js +3 -0
  23. package/dist/src/providerRuntime.js +3 -0
  24. package/dist/src/remote.js +3 -0
  25. package/dist/src/review.js +3 -0
  26. package/dist/src/rig.d.ts +30 -0
  27. package/dist/src/rig.js +26 -0
  28. package/dist/src/run-journal.d.ts +4 -4
  29. package/dist/src/run-journal.js +3 -0
  30. package/dist/src/run-session-journal.d.ts +53 -0
  31. package/dist/src/run-session-journal.js +1582 -0
  32. package/dist/src/run-status.d.ts +12 -0
  33. package/dist/src/run-status.js +38 -0
  34. package/dist/src/runtime.js +3 -0
  35. package/dist/src/server.js +3 -0
  36. package/dist/src/serviceFabric.js +3 -0
  37. package/dist/src/terminal.js +3 -0
  38. package/dist/src/validation.js +3 -0
  39. package/dist/src/workspace.js +3 -0
  40. package/dist/src/ws.d.ts +14 -0
  41. package/dist/src/ws.js +25 -0
  42. package/package.json +1 -1
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
@@ -17,6 +17,12 @@ export declare const TaskId: Schema.brand<Schema.Trim, "TaskId">;
17
17
  export type TaskId = typeof TaskId.Type;
18
18
  export declare const RunId: Schema.brand<Schema.Trim, "RunId">;
19
19
  export type RunId = typeof RunId.Type;
20
+ export declare const SafePathSegment: Schema.brand<Schema.Trim, "SafePathSegment">;
21
+ export type SafePathSegment = typeof SafePathSegment.Type;
22
+ export declare const SafeRunId: Schema.brand<Schema.Trim, "SafeRunId">;
23
+ export type SafeRunId = typeof SafeRunId.Type;
24
+ export declare const SafeGitRefComponent: Schema.brand<Schema.Trim, "SafeGitRefComponent">;
25
+ export type SafeGitRefComponent = typeof SafeGitRefComponent.Type;
20
26
  export declare const EngineRuntimeId: Schema.brand<Schema.Trim, "EngineRuntimeId">;
21
27
  export type EngineRuntimeId = typeof EngineRuntimeId.Type;
22
28
  export declare const ConversationId: Schema.brand<Schema.Trim, "ConversationId">;
@@ -13,6 +13,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
13
13
  var GraphId = makeEntityId("GraphId");
14
14
  var TaskId = makeEntityId("TaskId");
15
15
  var RunId = makeEntityId("RunId");
16
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
17
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
18
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
16
19
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
17
20
  var ConversationId = makeEntityId("ConversationId");
18
21
  var ActionId = makeEntityId("ActionId");
@@ -41,6 +44,9 @@ export {
41
44
  TrimmedNonEmptyString,
42
45
  ThreadId,
43
46
  TaskId,
47
+ SafeRunId,
48
+ SafePathSegment,
49
+ SafeGitRefComponent,
44
50
  RuntimeTaskId,
45
51
  RuntimeSessionId,
46
52
  RuntimeRequestId,
@@ -59,8 +59,27 @@ export declare const CliRepoConnectionState: Schema.Struct<{
59
59
  readonly project: Schema.optional<Schema.String>;
60
60
  readonly linkedAt: Schema.optional<Schema.String>;
61
61
  readonly serverProjectRoot: Schema.optional<Schema.String>;
62
+ readonly serverProjectRootAlias: Schema.optional<Schema.String>;
63
+ readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
62
64
  }>;
63
65
  export type CliRepoConnectionState = typeof CliRepoConnectionState.Type;
66
+ export declare const CliRemoteProjectLink: Schema.Struct<{
67
+ readonly ok: Schema.Boolean;
68
+ readonly status: Schema.String;
69
+ readonly alias: Schema.optional<Schema.String>;
70
+ readonly baseUrl: Schema.optional<Schema.String>;
71
+ readonly repoSlug: Schema.optional<Schema.String>;
72
+ readonly serverProjectRoot: Schema.optional<Schema.String>;
73
+ readonly source: Schema.optional<Schema.String>;
74
+ readonly prepared: Schema.optional<Schema.Boolean>;
75
+ readonly validated: Schema.optional<Schema.Boolean>;
76
+ readonly statusCode: Schema.optional<Schema.Number>;
77
+ readonly message: Schema.String;
78
+ readonly hint: Schema.String;
79
+ readonly next: Schema.optional<Schema.String>;
80
+ readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
81
+ }>;
82
+ export type CliRemoteProjectLink = typeof CliRemoteProjectLink.Type;
64
83
  export declare const RigTaskListOutput: Schema.Struct<{
65
84
  readonly v: Schema.Literal<1>;
66
85
  readonly command: Schema.Literal<"task list">;
@@ -125,6 +144,38 @@ export declare const RigRunShowOutput: Schema.Struct<{
125
144
  readonly data: Schema.$Record<Schema.String, Schema.Unknown>;
126
145
  }>;
127
146
  export type RigRunShowOutput = typeof RigRunShowOutput.Type;
147
+ export declare const RigServerUseOutput: Schema.Struct<{
148
+ readonly v: Schema.Literal<1>;
149
+ readonly command: Schema.Literal<"server use">;
150
+ readonly data: Schema.Struct<{
151
+ readonly selected: Schema.String;
152
+ readonly repo: Schema.NullOr<Schema.Struct<{
153
+ readonly selected: Schema.String;
154
+ readonly project: Schema.optional<Schema.String>;
155
+ readonly linkedAt: Schema.optional<Schema.String>;
156
+ readonly serverProjectRoot: Schema.optional<Schema.String>;
157
+ readonly serverProjectRootAlias: Schema.optional<Schema.String>;
158
+ readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
159
+ }>>;
160
+ readonly remoteProjectLink: Schema.NullOr<Schema.Struct<{
161
+ readonly ok: Schema.Boolean;
162
+ readonly status: Schema.String;
163
+ readonly alias: Schema.optional<Schema.String>;
164
+ readonly baseUrl: Schema.optional<Schema.String>;
165
+ readonly repoSlug: Schema.optional<Schema.String>;
166
+ readonly serverProjectRoot: Schema.optional<Schema.String>;
167
+ readonly source: Schema.optional<Schema.String>;
168
+ readonly prepared: Schema.optional<Schema.Boolean>;
169
+ readonly validated: Schema.optional<Schema.Boolean>;
170
+ readonly statusCode: Schema.optional<Schema.Number>;
171
+ readonly message: Schema.String;
172
+ readonly hint: Schema.String;
173
+ readonly next: Schema.optional<Schema.String>;
174
+ readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
175
+ }>>;
176
+ }>;
177
+ }>;
178
+ export type RigServerUseOutput = typeof RigServerUseOutput.Type;
128
179
  export declare const RigServerStatusOutput: Schema.Struct<{
129
180
  readonly v: Schema.Literal<1>;
130
181
  readonly command: Schema.Literal<"server status">;
@@ -135,6 +186,8 @@ export declare const RigServerStatusOutput: Schema.Struct<{
135
186
  readonly project: Schema.optional<Schema.String>;
136
187
  readonly linkedAt: Schema.optional<Schema.String>;
137
188
  readonly serverProjectRoot: Schema.optional<Schema.String>;
189
+ readonly serverProjectRootAlias: Schema.optional<Schema.String>;
190
+ readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
138
191
  }>>;
139
192
  readonly connections: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
140
193
  readonly kind: Schema.Literal<"local">;
@@ -143,9 +196,46 @@ export declare const RigServerStatusOutput: Schema.Struct<{
143
196
  readonly kind: Schema.Literal<"remote">;
144
197
  readonly baseUrl: Schema.String;
145
198
  }>]>>;
199
+ readonly remoteProjectLink: Schema.NullOr<Schema.Struct<{
200
+ readonly ok: Schema.Boolean;
201
+ readonly status: Schema.String;
202
+ readonly alias: Schema.optional<Schema.String>;
203
+ readonly baseUrl: Schema.optional<Schema.String>;
204
+ readonly repoSlug: Schema.optional<Schema.String>;
205
+ readonly serverProjectRoot: Schema.optional<Schema.String>;
206
+ readonly source: Schema.optional<Schema.String>;
207
+ readonly prepared: Schema.optional<Schema.Boolean>;
208
+ readonly validated: Schema.optional<Schema.Boolean>;
209
+ readonly statusCode: Schema.optional<Schema.Number>;
210
+ readonly message: Schema.String;
211
+ readonly hint: Schema.String;
212
+ readonly next: Schema.optional<Schema.String>;
213
+ readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
214
+ }>>;
146
215
  }>;
147
216
  }>;
148
217
  export type RigServerStatusOutput = typeof RigServerStatusOutput.Type;
218
+ export declare const RigServerRepairLinkOutput: Schema.Struct<{
219
+ readonly v: Schema.Literal<1>;
220
+ readonly command: Schema.Literal<"server repair-link">;
221
+ readonly data: Schema.Struct<{
222
+ readonly ok: Schema.Boolean;
223
+ readonly status: Schema.String;
224
+ readonly alias: Schema.optional<Schema.String>;
225
+ readonly baseUrl: Schema.optional<Schema.String>;
226
+ readonly repoSlug: Schema.optional<Schema.String>;
227
+ readonly serverProjectRoot: Schema.optional<Schema.String>;
228
+ readonly source: Schema.optional<Schema.String>;
229
+ readonly prepared: Schema.optional<Schema.Boolean>;
230
+ readonly validated: Schema.optional<Schema.Boolean>;
231
+ readonly statusCode: Schema.optional<Schema.Number>;
232
+ readonly message: Schema.String;
233
+ readonly hint: Schema.String;
234
+ readonly next: Schema.optional<Schema.String>;
235
+ readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
236
+ }>;
237
+ }>;
238
+ export type RigServerRepairLinkOutput = typeof RigServerRepairLinkOutput.Type;
149
239
  export declare const RigInboxApprovalsOutput: Schema.Struct<{
150
240
  readonly v: Schema.Literal<1>;
151
241
  readonly command: Schema.Literal<"inbox approvals">;
@@ -43,7 +43,25 @@ var CliRepoConnectionState = Schema.Struct({
43
43
  selected: Schema.String,
44
44
  project: Schema.optional(Schema.String),
45
45
  linkedAt: Schema.optional(Schema.String),
46
- serverProjectRoot: Schema.optional(Schema.String)
46
+ serverProjectRoot: Schema.optional(Schema.String),
47
+ serverProjectRootAlias: Schema.optional(Schema.String),
48
+ serverProjectRootBaseUrl: Schema.optional(Schema.String)
49
+ });
50
+ var CliRemoteProjectLink = Schema.Struct({
51
+ ok: Schema.Boolean,
52
+ status: Schema.String,
53
+ alias: Schema.optional(Schema.String),
54
+ baseUrl: Schema.optional(Schema.String),
55
+ repoSlug: Schema.optional(Schema.String),
56
+ serverProjectRoot: Schema.optional(Schema.String),
57
+ source: Schema.optional(Schema.String),
58
+ prepared: Schema.optional(Schema.Boolean),
59
+ validated: Schema.optional(Schema.Boolean),
60
+ statusCode: Schema.optional(Schema.Number),
61
+ message: Schema.String,
62
+ hint: Schema.String,
63
+ next: Schema.optional(Schema.String),
64
+ skippedCandidates: Schema.optional(Schema.Array(Schema.String))
47
65
  });
48
66
  var RigTaskListOutput = Schema.Struct({
49
67
  v: Schema.Literal(1),
@@ -76,15 +94,30 @@ var RigRunShowOutput = Schema.Struct({
76
94
  command: Schema.Literal("run show"),
77
95
  data: CliRunRecord
78
96
  });
97
+ var RigServerUseOutput = Schema.Struct({
98
+ v: Schema.Literal(1),
99
+ command: Schema.Literal("server use"),
100
+ data: Schema.Struct({
101
+ selected: Schema.String,
102
+ repo: Schema.NullOr(CliRepoConnectionState),
103
+ remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
104
+ })
105
+ });
79
106
  var RigServerStatusOutput = Schema.Struct({
80
107
  v: Schema.Literal(1),
81
108
  command: Schema.Literal("server status"),
82
109
  data: Schema.Struct({
83
110
  selected: Schema.String,
84
111
  repo: Schema.NullOr(CliRepoConnectionState),
85
- connections: Schema.Record(Schema.String, CliServerConnection)
112
+ connections: Schema.Record(Schema.String, CliServerConnection),
113
+ remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
86
114
  })
87
115
  });
116
+ var RigServerRepairLinkOutput = Schema.Struct({
117
+ v: Schema.Literal(1),
118
+ command: Schema.Literal("server repair-link"),
119
+ data: CliRemoteProjectLink
120
+ });
88
121
  var RigInboxApprovalsOutput = Schema.Struct({
89
122
  v: Schema.Literal(1),
90
123
  command: Schema.Literal("inbox approvals"),
@@ -136,7 +169,9 @@ export {
136
169
  RigTaskListOutput,
137
170
  RigStatsOutput,
138
171
  RigStatsData,
172
+ RigServerUseOutput,
139
173
  RigServerStatusOutput,
174
+ RigServerRepairLinkOutput,
140
175
  RigRunShowOutput,
141
176
  RigRunListOutput,
142
177
  RigInboxInputsOutput,
@@ -148,6 +183,7 @@ export {
148
183
  CliServerConnection,
149
184
  CliRunRecord,
150
185
  CliRepoConnectionState,
186
+ CliRemoteProjectLink,
151
187
  CliInboxRecord,
152
188
  CliDoctorCheck,
153
189
  CLI_OUTPUT_VERSION
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
package/dist/src/git.js CHANGED
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
package/dist/src/graph.js CHANGED
@@ -16,6 +16,9 @@ var WorkspaceId = makeEntityId("WorkspaceId");
16
16
  var GraphId = makeEntityId("GraphId");
17
17
  var TaskId = makeEntityId("TaskId");
18
18
  var RunId = makeEntityId("RunId");
19
+ var SafePathSegment = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafePathSegment"));
20
+ var SafeRunId = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/)).pipe(Schema.brand("SafeRunId"));
21
+ var SafeGitRefComponent = TrimmedNonEmptyString.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/)).pipe(Schema.brand("SafeGitRefComponent"));
19
22
  var EngineRuntimeId = makeEntityId("EngineRuntimeId");
20
23
  var ConversationId = makeEntityId("ConversationId");
21
24
  var ActionId = makeEntityId("ActionId");
@@ -0,0 +1,30 @@
1
+ export type HelpCommand = {
2
+ command: string;
3
+ description: string;
4
+ primary?: boolean;
5
+ };
6
+ export type HelpGroup = {
7
+ name: string;
8
+ summary: string;
9
+ usage: string[];
10
+ commands: HelpCommand[];
11
+ examples?: string[];
12
+ next?: string[];
13
+ advanced?: string[];
14
+ };
15
+ export type TopLevelSection = {
16
+ title: string;
17
+ subtitle: string;
18
+ commands: HelpCommand[];
19
+ };
20
+ /** Catalog DATA for the app's help view — the view builds its own layout
21
+ * from these; the render* functions below remain for plain/script output. */
22
+ export declare function helpCatalog(): {
23
+ sections: readonly TopLevelSection[];
24
+ groups: readonly HelpGroup[];
25
+ };
26
+ export declare const TOP_LEVEL_SECTIONS: TopLevelSection[];
27
+ export declare const PRIMARY_GROUPS: HelpGroup[];
28
+ export declare const ADVANCED_GROUPS: HelpGroup[];
29
+ export declare const ADVANCED_COMMANDS: HelpCommand[];
30
+ export declare const ALL_GROUPS: HelpGroup[];