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

package/dist/src/plugin-hooks.js

@@ -0,0 +1,386 @@
+// @bun
+// packages/contracts/src/plugin-hooks.ts
+import { Schema as Schema5 } from "effect";
+
+// packages/contracts/src/plugin.ts
+import { Schema as Schema4 } from "effect";
+
+// packages/contracts/src/kernel.ts
+import { Schema as Schema3 } from "effect";
+
+// packages/contracts/src/baseSchemas.ts
+import { Schema } from "effect";
+var TrimmedString = Schema.Trim;
+var TrimmedNonEmptyString = TrimmedString.check(Schema.isNonEmpty());
+var NonNegativeInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+var PositiveInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+var IsoDateTime = Schema.String;
+var makeEntityId = (brand) => TrimmedNonEmptyString.pipe(Schema.brand(brand));
+var ThreadId = makeEntityId("ThreadId");
+var ProjectId = makeEntityId("ProjectId");
+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");
+var ArtifactId = makeEntityId("ArtifactId");
+var WorktreeId = makeEntityId("WorktreeId");
+var ValidationResultId = makeEntityId("ValidationResultId");
+var ReviewResultId = makeEntityId("ReviewResultId");
+var CommandId = makeEntityId("CommandId");
+var EventId = makeEntityId("EventId");
+var MessageId = makeEntityId("MessageId");
+var TurnId = makeEntityId("TurnId");
+var ProviderItemId = makeEntityId("ProviderItemId");
+var RuntimeSessionId = makeEntityId("RuntimeSessionId");
+var RuntimeItemId = makeEntityId("RuntimeItemId");
+var RuntimeRequestId = makeEntityId("RuntimeRequestId");
+var RuntimeTaskId = makeEntityId("RuntimeTaskId");
+var ApprovalRequestId = makeEntityId("ApprovalRequestId");
+var CheckpointRef = makeEntityId("CheckpointRef");
+var RemoteEndpointId = makeEntityId("RemoteEndpointId");
+
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/stage.ts
+import { Schema as Schema2 } from "effect";
+var StageKind = Schema2.Literals(["transform", "gate", "observe"]);
+var StageId = TrimmedNonEmptyString.pipe(Schema2.brand("StageId"));
+var StageContext = Schema2.Struct({
+  runId: RunId,
+  taskId: Schema2.optional(Schema2.NullOr(TaskId)),
+  state: Schema2.Unknown,
+  metadata: Schema2.optional(Schema2.Record(Schema2.String, Schema2.Unknown))
+});
+var StageDescriptor = Schema2.Struct({
+  id: StageId,
+  kind: StageKind,
+  before: Schema2.optional(Schema2.Array(StageId)),
+  after: Schema2.optional(Schema2.Array(StageId)),
+  priority: Schema2.Number.pipe(Schema2.withDecodingDefault(() => 0)),
+  protected: Schema2.Boolean.pipe(Schema2.withDecodingDefault(() => false))
+});
+var Stage = StageDescriptor;
+var StageContinueResult = Schema2.Struct({
+  kind: Schema2.Literal("continue"),
+  ctx: StageContext
+});
+var StageAllowResult = Schema2.Struct({
+  kind: Schema2.Literal("allow")
+});
+var StageBlockResult = Schema2.Struct({
+  kind: Schema2.Literal("block"),
+  reason: TrimmedNonEmptyString
+});
+var StageResult = Schema2.Union([
+  StageContinueResult,
+  StageAllowResult,
+  StageBlockResult
+]);
+var StageWrapperDescriptor = Schema2.Struct({
+  id: TrimmedNonEmptyString,
+  priority: Schema2.Number.pipe(Schema2.withDecodingDefault(() => 0))
+});
+var StageMutationOp = Schema2.Literals(["insert", "remove", "replace", "wrap", "reorder"]);
+var InsertStageMutation = Schema2.Struct({
+  op: Schema2.Literal("insert"),
+  stage: StageDescriptor,
+  contributedBy: Schema2.optional(TrimmedNonEmptyString)
+});
+var RemoveStageMutation = Schema2.Struct({
+  op: Schema2.Literal("remove"),
+  id: StageId,
+  contributedBy: Schema2.optional(TrimmedNonEmptyString)
+});
+var ReplaceStageMutation = Schema2.Struct({
+  op: Schema2.Literal("replace"),
+  id: StageId,
+  stage: StageDescriptor,
+  contributedBy: Schema2.optional(TrimmedNonEmptyString)
+});
+var WrapStageMutation = Schema2.Struct({
+  op: Schema2.Literal("wrap"),
+  id: StageId,
+  around: StageWrapperDescriptor,
+  contributedBy: Schema2.optional(TrimmedNonEmptyString)
+});
+var ReorderStageMutation = Schema2.Struct({
+  op: Schema2.Literal("reorder"),
+  id: StageId,
+  before: Schema2.optional(Schema2.Array(StageId)),
+  after: Schema2.optional(Schema2.Array(StageId)),
+  contributedBy: Schema2.optional(TrimmedNonEmptyString)
+});
+var StageMutation = Schema2.Union([
+  InsertStageMutation,
+  RemoveStageMutation,
+  ReplaceStageMutation,
+  WrapStageMutation,
+  ReorderStageMutation
+]);
+var ResolutionGrantUse = Schema2.Struct({
+  kind: Schema2.Literal("kernel-replacement"),
+  target: TrimmedNonEmptyString,
+  pluginId: TrimmedNonEmptyString
+});
+var ResolutionRecordEntry = Schema2.Struct({
+  stageId: StageId,
+  contributedBy: TrimmedNonEmptyString,
+  removedBy: Schema2.optional(TrimmedNonEmptyString),
+  replacedBy: Schema2.optional(TrimmedNonEmptyString),
+  wrappedBy: Schema2.optional(Schema2.Array(TrimmedNonEmptyString)),
+  droppedAnchors: Schema2.optional(Schema2.Array(StageId)),
+  isProtected: Schema2.Boolean
+});
+var ResolvedPipeline = Schema2.Struct({
+  runId: Schema2.optional(RunId),
+  order: Schema2.Array(StageId),
+  record: Schema2.Array(ResolutionRecordEntry),
+  cycles: Schema2.Array(Schema2.Array(StageId)),
+  grantUses: Schema2.optional(Schema2.Array(ResolutionGrantUse)),
+  resolvedAt: Schema2.optional(IsoDateTime)
+});
+var StageRunOutcome = Schema2.Struct({
+  stageId: StageId,
+  result: StageResult,
+  startedAt: IsoDateTime,
+  finishedAt: IsoDateTime
+});
+
+// packages/contracts/src/kernel.ts
+var CapabilityTag = Schema3.Literals([
+  "kernel",
+  "journal",
+  "stage-runner",
+  "transport",
+  "loader-policy"
+]);
+var CapabilityProviderRef = Schema3.Struct({
+  capability: CapabilityTag,
+  pluginId: TrimmedNonEmptyString
+});
+var CapabilityReplacement = Schema3.Struct({
+  capability: CapabilityTag,
+  providerPluginId: TrimmedNonEmptyString
+});
+var CapabilityReplacementSpec = Schema3.Union([
+  CapabilityReplacement,
+  TrimmedNonEmptyString
+]);
+var KernelReplacementGrant = Schema3.Struct({
+  pluginId: TrimmedNonEmptyString,
+  grantedBy: Schema3.optional(TrimmedNonEmptyString),
+  reason: Schema3.optional(Schema3.String)
+});
+var CapabilityGrants = Schema3.Struct({
+  capabilityPrecedence: Schema3.optional(Schema3.Record(Schema3.String, Schema3.Array(TrimmedNonEmptyString))),
+  kernelReplacementGrants: Schema3.optional(Schema3.Array(KernelReplacementGrant))
+});
+var KernelBootErrorCode = Schema3.Literals([
+  "BootIncoherent",
+  "AmbiguousCapability",
+  "MissingCapability",
+  "KernelReplacementDenied",
+  "PipelineUnresolvable"
+]);
+var KernelBootError = Schema3.Struct({
+  code: KernelBootErrorCode,
+  message: TrimmedNonEmptyString,
+  capability: Schema3.optional(CapabilityTag),
+  stageId: Schema3.optional(TrimmedNonEmptyString),
+  pluginIds: Schema3.optional(Schema3.Array(TrimmedNonEmptyString))
+});
+var CapabilityResolutionStatus = Schema3.Literals(["resolved", "ambiguous", "missing", "replaced"]);
+var CapabilityResolutionRecord = Schema3.Struct({
+  capability: CapabilityTag,
+  status: CapabilityResolutionStatus,
+  selectedPluginId: Schema3.NullOr(TrimmedNonEmptyString),
+  candidatePluginIds: Schema3.Array(TrimmedNonEmptyString),
+  precedenceUsed: Schema3.Boolean,
+  replacementUsed: Schema3.optional(CapabilityReplacement),
+  error: Schema3.optional(Schema3.String)
+});
+var KernelResolutionRecord = Schema3.Struct({
+  resolvedAt: IsoDateTime,
+  capabilities: Schema3.Array(CapabilityResolutionRecord),
+  pipeline: Schema3.optional(ResolvedPipeline)
+});
+var BootResultDescriptor = Schema3.Struct({
+  kernelPluginId: TrimmedNonEmptyString,
+  pluginIds: Schema3.Array(TrimmedNonEmptyString),
+  resolution: KernelResolutionRecord
+});
+var JournalEvent = Schema3.Struct({
+  type: TrimmedNonEmptyString,
+  runId: Schema3.optional(RunId),
+  at: IsoDateTime,
+  payload: Schema3.Unknown
+});
+var PLACEMENT_RUN_TRANSPORT = makeCapabilityId("transport.placement-run");
+
+// packages/contracts/src/plugin.ts
+var ValidatorCategory = Schema4.Literals([
+  "boundary",
+  "contract",
+  "integration",
+  "regression",
+  "external",
+  "custom"
+]);
+var ValidatorRegistration = Schema4.Struct({
+  id: Schema4.String,
+  category: ValidatorCategory,
+  description: Schema4.optional(Schema4.String)
+});
+var AgentSessionHookEvent = Schema4.Literals([
+  "PreToolUse",
+  "PostToolUse",
+  "UserPromptSubmit",
+  "Stop",
+  "SessionStart",
+  "SessionEnd"
+]);
+var HookMatcher = Schema4.Union([
+  Schema4.Struct({ kind: Schema4.Literal("all") }),
+  Schema4.Struct({ kind: Schema4.Literal("tool"), name: Schema4.String }),
+  Schema4.Struct({ kind: Schema4.Literal("glob"), pattern: Schema4.String })
+]);
+var HookRegistration = Schema4.Struct({
+  id: Schema4.String,
+  event: AgentSessionHookEvent,
+  matcher: HookMatcher,
+  command: Schema4.optional(Schema4.String),
+  description: Schema4.optional(Schema4.String)
+});
+var SkillRegistration = Schema4.Struct({
+  id: Schema4.String,
+  path: Schema4.String,
+  description: Schema4.optional(Schema4.String)
+});
+var RepoSourceRegistration = Schema4.Struct({
+  id: Schema4.String,
+  url: Schema4.String,
+  defaultPath: Schema4.optional(Schema4.String),
+  description: Schema4.optional(Schema4.String),
+  defaultBranch: Schema4.optional(Schema4.String),
+  remoteEnvVar: Schema4.optional(Schema4.String),
+  checkoutEnvVar: Schema4.optional(Schema4.String)
+});
+var AgentRoleRegistration = Schema4.Struct({
+  id: Schema4.String,
+  defaultModel: Schema4.optional(Schema4.String),
+  description: Schema4.optional(Schema4.String)
+});
+var TaskFieldExtension = Schema4.Struct({
+  id: Schema4.String,
+  fieldName: Schema4.String,
+  schemaJson: Schema4.String
+});
+var TaskSourceKind = Schema4.String;
+var TaskSourceRegistration = Schema4.Struct({
+  id: Schema4.String,
+  kind: Schema4.String,
+  description: Schema4.optional(Schema4.String)
+});
+var CliCommandRegistration = Schema4.Struct({
+  id: Schema4.String,
+  family: Schema4.optional(Schema4.String),
+  command: Schema4.optional(Schema4.String),
+  description: Schema4.optional(Schema4.String),
+  usage: Schema4.optional(Schema4.String),
+  aliases: Schema4.optional(Schema4.Array(Schema4.String)),
+  projectRequired: Schema4.optional(Schema4.Boolean),
+  rootDefault: Schema4.optional(Schema4.Boolean),
+  productRoot: Schema4.optional(Schema4.Boolean),
+  subcommands: Schema4.optional(Schema4.Array(Schema4.String))
+});
+var CapabilityRunSchema = Schema4.declare((u) => typeof u === "function", { identifier: "CapabilityRun" });
+var ProductCapabilityRegistration = Schema4.Struct({
+  id: Schema4.String,
+  title: Schema4.String,
+  description: Schema4.optional(Schema4.String),
+  commandId: Schema4.optional(Schema4.String),
+  panelId: Schema4.optional(Schema4.String),
+  run: Schema4.optional(CapabilityRunSchema)
+});
+var PanelRegistration = Schema4.Struct({
+  id: Schema4.String,
+  slot: Schema4.String,
+  title: Schema4.String,
+  capabilityId: Schema4.optional(Schema4.String),
+  badge: Schema4.optional(Schema4.String),
+  disabled: Schema4.optional(Schema4.Boolean),
+  description: Schema4.optional(Schema4.String)
+});
+var BlockerClassifierRegistration = Schema4.Struct({
+  id: Schema4.String,
+  description: Schema4.optional(Schema4.String),
+  priority: Schema4.optional(Schema4.Number)
+});
+var SessionExtensionRegistration = Schema4.Struct({
+  id: Schema4.String,
+  description: Schema4.optional(Schema4.String)
+});
+var SeedEntrypointRegistration = Schema4.Struct({
+  id: Schema4.String,
+  description: Schema4.optional(Schema4.String),
+  basename: Schema4.optional(Schema4.String),
+  workerArg: Schema4.optional(Schema4.String),
+  insidePty: Schema4.optional(Schema4.Boolean)
+});
+var PluginContributes = Schema4.Struct({
+  validators: Schema4.optional(Schema4.Array(ValidatorRegistration)),
+  hooks: Schema4.optional(Schema4.Array(HookRegistration)),
+  skills: Schema4.optional(Schema4.Array(SkillRegistration)),
+  repoSources: Schema4.optional(Schema4.Array(RepoSourceRegistration)),
+  agentRoles: Schema4.optional(Schema4.Array(AgentRoleRegistration)),
+  taskFieldSchemas: Schema4.optional(Schema4.Array(TaskFieldExtension)),
+  taskSources: Schema4.optional(Schema4.Array(TaskSourceRegistration)),
+  cliCommands: Schema4.optional(Schema4.Array(CliCommandRegistration)),
+  stages: Schema4.optional(Schema4.Array(Stage)),
+  stageMutations: Schema4.optional(Schema4.Array(StageMutation)),
+  capabilities: Schema4.optional(Schema4.Array(ProductCapabilityRegistration)),
+  panels: Schema4.optional(Schema4.Array(PanelRegistration)),
+  blockerClassifiers: Schema4.optional(Schema4.Array(BlockerClassifierRegistration)),
+  sessionExtensions: Schema4.optional(Schema4.Array(SessionExtensionRegistration)),
+  seedEntrypoints: Schema4.optional(Schema4.Array(SeedEntrypointRegistration))
+});
+var RigPlugin = Schema4.Struct({
+  name: Schema4.String,
+  version: Schema4.String,
+  provides: Schema4.optional(Schema4.Array(CapabilityTag)),
+  requires: Schema4.optional(Schema4.Array(CapabilityTag)),
+  replaces: Schema4.optional(Schema4.Array(CapabilityReplacementSpec)),
+  contributes: Schema4.optional(PluginContributes)
+});
+
+// packages/contracts/src/plugin-hooks.ts
+var HookToolInput = Schema5.Record(Schema5.String, Schema5.Unknown);
+var HookContext = Schema5.Struct({
+  event: AgentSessionHookEvent,
+  toolName: Schema5.optional(Schema5.String),
+  toolInput: HookToolInput,
+  filePaths: Schema5.Array(Schema5.String),
+  projectRoot: Schema5.String,
+  taskId: Schema5.String
+});
+var HookDecision = Schema5.Literals(["allow", "block"]);
+var HookResult = Schema5.Struct({
+  decision: HookDecision,
+  reason: Schema5.optional(Schema5.String),
+  systemMessage: Schema5.optional(Schema5.String)
+});
+export {
+  HookToolInput,
+  HookResult,
+  HookDecision,
+  HookContext
+};