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

package/dist/src/native-toolchain.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mechanical native-toolchain capability seams.
+ *
+ * These contracts describe binary build/materialization services only. Repo
+ * meaning, task scoping, repo-native git wrappers, and git workflow semantics
+ * belong to repo contracts; native-toolchain providers only locate, compile, or
+ * materialize binaries.
+ *
+ * Pure: types + branded ids, no behaviour.
+ */
+import type { CapabilityId } from "./capability-id";
+export type NativeToolchainBinaryKind = "executable" | "dynamic-library";
+export interface NativeToolchainTarget {
+    readonly platform: string;
+    readonly arch: string;
+    readonly triple?: string;
+    readonly abi?: string;
+}
+export interface NativeToolchainBinaryArtifact {
+    readonly name: string;
+    readonly path: string;
+    readonly kind: NativeToolchainBinaryKind;
+    readonly target?: NativeToolchainTarget;
+}
+export interface NativeToolchainBinaryBuildInput {
+    readonly projectRoot: string;
+    readonly name: string;
+    readonly sourcePath: string;
+    readonly outputPath: string;
+    readonly kind: NativeToolchainBinaryKind;
+    readonly target?: NativeToolchainTarget;
+    readonly buildArgs?: readonly string[];
+    readonly defines?: Readonly<Record<string, string>>;
+}
+export interface NativeToolchainBinaryMaterializeInput {
+    readonly projectRoot: string;
+    readonly name: string;
+    readonly targetDir: string;
+    readonly target?: NativeToolchainTarget;
+}
+export interface NativeToolchainBinaryBuildService {
+    buildNativeBinary(input: NativeToolchainBinaryBuildInput): Promise<NativeToolchainBinaryArtifact>;
+    materializeNativeBinary(input: NativeToolchainBinaryMaterializeInput): Promise<NativeToolchainBinaryArtifact>;
+}
+export declare const NATIVE_TOOLCHAIN_BINARY_BUILD_CAPABILITY_ID = "native-toolchain.binary-build";
+export declare const NATIVE_TOOLCHAIN_BINARY_BUILD: CapabilityId<NativeToolchainBinaryBuildService>;

package/dist/src/native-toolchain.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/native-toolchain.ts
+var NATIVE_TOOLCHAIN_BINARY_BUILD_CAPABILITY_ID = "native-toolchain.binary-build";
+var NATIVE_TOOLCHAIN_BINARY_BUILD = makeCapabilityId(NATIVE_TOOLCHAIN_BINARY_BUILD_CAPABILITY_ID);
+export {
+  NATIVE_TOOLCHAIN_BINARY_BUILD_CAPABILITY_ID,
+  NATIVE_TOOLCHAIN_BINARY_BUILD
+};

package/dist/src/notify.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure NOTIFY capability vocab.
+ *
+ * The neutral home for the notification event/target data types and the typed
+ * capability seam so the floor (and any consumer) can resolve a notifier off a
+ * plugin host WITHOUT importing the provider package. Carries no behaviour —
+ * exactly like `browser.ts` / `memory.ts`.
+ *
+ * `@rig/notifications-plugin` provides the concrete `NotifyService` impl
+ * (config load + target selection = policy) under
+ * {@link NOTIFY_SERVICE_CAPABILITY} via the `defineCapability` seam.
+ */
+import type { CapabilityId } from "./capability-id";
+/** A Rig lifecycle event eligible for outbound notification. */
+export type RigEvent = {
+    id?: string;
+    runId?: string;
+    timestamp?: string;
+    type: string;
+    payload?: Record<string, unknown>;
+};
+/** A configured outbound notification channel. */
+export type NotificationTarget = {
+    id: string;
+    type: "slack-webhook" | "linear-webhook" | "notion-webhook" | "generic-webhook";
+    url: string;
+    enabled?: boolean;
+    events?: string[];
+    headers?: Record<string, string>;
+};
+/** The on-disk notification policy (`.rig/notifications.json`). */
+export type NotificationConfig = {
+    targets: NotificationTarget[];
+};
+/** Capability id the notifications plugin registers its `NotifyService` under. */
+export declare const NOTIFY_SERVICE_CAPABILITY_ID = "notify.dispatch";
+/**
+ * The cohesive notify operation consumers depend on. The impl owns the policy:
+ * which targets receive which events, loaded from the project's
+ * `.rig/notifications.json`. Returns the count of targets successfully notified.
+ */
+export interface NotifyService {
+    notify(event: RigEvent): Promise<number>;
+}
+/** Typed capability id the notifications plugin provides and consumers require. */
+export declare const NOTIFY_SERVICE_CAPABILITY: CapabilityId<NotifyService>;

package/dist/src/notify.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/notify.ts
+var NOTIFY_SERVICE_CAPABILITY_ID = "notify.dispatch";
+var NOTIFY_SERVICE_CAPABILITY = makeCapabilityId(NOTIFY_SERVICE_CAPABILITY_ID);
+export {
+  NOTIFY_SERVICE_CAPABILITY_ID,
+  NOTIFY_SERVICE_CAPABILITY
+};

package/dist/src/orchestration.d.ts

@@ -0,0 +1,43 @@
+import { Schema } from "effect";
+export declare const ProviderKind: Schema.Literals<readonly ["codex", "claude"]>;
+export type ProviderKind = typeof ProviderKind.Type;
+export declare const ProviderApprovalPolicy: Schema.Literals<readonly ["untrusted", "on-failure", "on-request", "never"]>;
+export type ProviderApprovalPolicy = typeof ProviderApprovalPolicy.Type;
+export declare const ProviderSandboxMode: Schema.Literals<readonly ["read-only", "workspace-write", "danger-full-access"]>;
+export type ProviderSandboxMode = typeof ProviderSandboxMode.Type;
+export declare const ProviderServiceTier: Schema.Literals<readonly ["fast", "flex"]>;
+export type ProviderServiceTier = typeof ProviderServiceTier.Type;
+export declare const RuntimeMode: Schema.Literals<readonly ["approval-required", "full-access"]>;
+export type RuntimeMode = typeof RuntimeMode.Type;
+export declare const DEFAULT_RUNTIME_MODE: RuntimeMode;
+export declare const ProviderInteractionMode: Schema.Literals<readonly ["default", "plan"]>;
+export type ProviderInteractionMode = typeof ProviderInteractionMode.Type;
+export declare const DEFAULT_PROVIDER_INTERACTION_MODE: ProviderInteractionMode;
+export declare const ProviderRequestKind: Schema.Literals<readonly ["command", "file-read", "file-change"]>;
+export type ProviderRequestKind = typeof ProviderRequestKind.Type;
+export declare const ProviderApprovalDecision: Schema.Literals<readonly ["accept", "acceptForSession", "decline", "cancel"]>;
+export type ProviderApprovalDecision = typeof ProviderApprovalDecision.Type;
+export declare const ProviderUserInputAnswers: Schema.$Record<Schema.String, Schema.Unknown>;
+export type ProviderUserInputAnswers = typeof ProviderUserInputAnswers.Type;
+export declare const PROVIDER_SEND_TURN_MAX_INPUT_CHARS = 120000;
+export declare const PROVIDER_SEND_TURN_MAX_ATTACHMENTS = 8;
+export declare const PROVIDER_SEND_TURN_MAX_IMAGE_BYTES: number;
+declare const ChatAttachmentId: Schema.Trim;
+export type ChatAttachmentId = typeof ChatAttachmentId.Type;
+export declare const ChatImageAttachment: Schema.Struct<{
+    readonly type: Schema.Literal<"image">;
+    readonly id: Schema.Trim;
+    readonly name: Schema.Trim;
+    readonly mimeType: Schema.Trim;
+    readonly sizeBytes: Schema.Int;
+}>;
+export type ChatImageAttachment = typeof ChatImageAttachment.Type;
+export declare const ChatAttachment: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"image">;
+    readonly id: Schema.Trim;
+    readonly name: Schema.Trim;
+    readonly mimeType: Schema.Trim;
+    readonly sizeBytes: Schema.Int;
+}>]>;
+export type ChatAttachment = typeof ChatAttachment.Type;
+export {};