@h-rig/contracts 0.0.6-alpha.157 → 0.0.6-alpha.159

package/dist/src/plugin-hooks.js

@@ -45,6 +45,11 @@ 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"]);
@@ -219,6 +224,7 @@ var JournalEvent = Schema3.Struct({
   at: IsoDateTime,
   payload: Schema3.Unknown
 });
+var PLACEMENT_RUN_TRANSPORT = makeCapabilityId("transport.placement-run");
 
 // packages/contracts/src/plugin.ts
 var ValidatorCategory = Schema4.Literals([
@@ -291,14 +297,19 @@ var CliCommandRegistration = Schema4.Struct({
   description: Schema4.optional(Schema4.String),
   usage: Schema4.optional(Schema4.String),
   aliases: Schema4.optional(Schema4.Array(Schema4.String)),
-  projectRequired: Schema4.optional(Schema4.Boolean)
+  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)
+  panelId: Schema4.optional(Schema4.String),
+  run: Schema4.optional(CapabilityRunSchema)
 });
 var PanelRegistration = Schema4.Struct({
   id: Schema4.String,
@@ -318,6 +329,13 @@ 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)),
@@ -332,7 +350,8 @@ var PluginContributes = Schema4.Struct({
   capabilities: Schema4.optional(Schema4.Array(ProductCapabilityRegistration)),
   panels: Schema4.optional(Schema4.Array(PanelRegistration)),
   blockerClassifiers: Schema4.optional(Schema4.Array(BlockerClassifierRegistration)),
-  sessionExtensions: Schema4.optional(Schema4.Array(SessionExtensionRegistration))
+  sessionExtensions: Schema4.optional(Schema4.Array(SessionExtensionRegistration)),
+  seedEntrypoints: Schema4.optional(Schema4.Array(SeedEntrypointRegistration))
 });
 var RigPlugin = Schema4.Struct({
   name: Schema4.String,

package/dist/src/plugin.d.ts

@@ -92,14 +92,31 @@ export declare const CliCommandRegistration: Schema.Struct<{
     readonly usage: Schema.optional<Schema.String>;
     readonly aliases: Schema.optional<Schema.$Array<Schema.String>>;
     readonly projectRequired: Schema.optional<Schema.Boolean>;
+    readonly rootDefault: Schema.optional<Schema.Boolean>;
+    readonly productRoot: Schema.optional<Schema.Boolean>;
+    readonly subcommands: Schema.optional<Schema.$Array<Schema.String>>;
 }>;
 export type CliCommandRegistration = typeof CliCommandRegistration.Type;
+/**
+ * The executable resolver a capability provider contributes. ON-CONTRACT: this
+ * is the single capability channel — the impl no longer "rides alongside" the
+ * manifest, ignored by Schema decode. It is declared (not a serializable shape)
+ * because it carries a function; manifest validation accepts it, JSON
+ * serialization simply omits it (functions are not JSON), exactly mirroring the
+ * old strip-on-decode behaviour but with the field now part of the type.
+ */
+export interface CapabilityRun {
+    (input: unknown): Promise<unknown> | unknown;
+}
+/** Schema vocab for {@link CapabilityRun} — a type-guard refinement, no behaviour. */
+export declare const CapabilityRunSchema: Schema.declare<CapabilityRun, CapabilityRun>;
 export declare const ProductCapabilityRegistration: Schema.Struct<{
     readonly id: Schema.String;
     readonly title: Schema.String;
     readonly description: Schema.optional<Schema.String>;
     readonly commandId: Schema.optional<Schema.String>;
     readonly panelId: Schema.optional<Schema.String>;
+    readonly run: Schema.optional<Schema.declare<CapabilityRun, CapabilityRun>>;
 }>;
 export type ProductCapabilityRegistration = typeof ProductCapabilityRegistration.Type;
 export declare const PanelRegistration: Schema.Struct<{
@@ -123,6 +140,14 @@ export declare const SessionExtensionRegistration: Schema.Struct<{
     readonly description: Schema.optional<Schema.String>;
 }>;
 export type SessionExtensionRegistration = typeof SessionExtensionRegistration.Type;
+export declare const SeedEntrypointRegistration: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly description: Schema.optional<Schema.String>;
+    readonly basename: Schema.optional<Schema.String>;
+    readonly workerArg: Schema.optional<Schema.String>;
+    readonly insidePty: Schema.optional<Schema.Boolean>;
+}>;
+export type SeedEntrypointRegistration = typeof SeedEntrypointRegistration.Type;
 export declare const PluginContributes: Schema.Struct<{
     readonly validators: Schema.optional<Schema.$Array<Schema.Struct<{
         readonly id: Schema.String;
@@ -192,6 +217,9 @@ export declare const PluginContributes: Schema.Struct<{
         readonly usage: Schema.optional<Schema.String>;
         readonly aliases: Schema.optional<Schema.$Array<Schema.String>>;
         readonly projectRequired: Schema.optional<Schema.Boolean>;
+        readonly rootDefault: Schema.optional<Schema.Boolean>;
+        readonly productRoot: Schema.optional<Schema.Boolean>;
+        readonly subcommands: Schema.optional<Schema.$Array<Schema.String>>;
     }>>>;
     readonly stages: Schema.optional<Schema.$Array<Schema.Struct<{
         readonly id: Schema.brand<Schema.Trim, "StageId">;
@@ -249,6 +277,7 @@ export declare const PluginContributes: Schema.Struct<{
         readonly description: Schema.optional<Schema.String>;
         readonly commandId: Schema.optional<Schema.String>;
         readonly panelId: Schema.optional<Schema.String>;
+        readonly run: Schema.optional<Schema.declare<CapabilityRun, CapabilityRun>>;
     }>>>;
     readonly panels: Schema.optional<Schema.$Array<Schema.Struct<{
         readonly id: Schema.String;
@@ -268,6 +297,13 @@ export declare const PluginContributes: Schema.Struct<{
         readonly id: Schema.String;
         readonly description: Schema.optional<Schema.String>;
     }>>>;
+    readonly seedEntrypoints: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly description: Schema.optional<Schema.String>;
+        readonly basename: Schema.optional<Schema.String>;
+        readonly workerArg: Schema.optional<Schema.String>;
+        readonly insidePty: Schema.optional<Schema.Boolean>;
+    }>>>;
 }>;
 export type PluginContributes = typeof PluginContributes.Type;
 export declare const RigPlugin: Schema.Struct<{
@@ -348,6 +384,9 @@ export declare const RigPlugin: Schema.Struct<{
             readonly usage: Schema.optional<Schema.String>;
             readonly aliases: Schema.optional<Schema.$Array<Schema.String>>;
             readonly projectRequired: Schema.optional<Schema.Boolean>;
+            readonly rootDefault: Schema.optional<Schema.Boolean>;
+            readonly productRoot: Schema.optional<Schema.Boolean>;
+            readonly subcommands: Schema.optional<Schema.$Array<Schema.String>>;
         }>>>;
         readonly stages: Schema.optional<Schema.$Array<Schema.Struct<{
             readonly id: Schema.brand<Schema.Trim, "StageId">;
@@ -405,6 +444,7 @@ export declare const RigPlugin: Schema.Struct<{
             readonly description: Schema.optional<Schema.String>;
             readonly commandId: Schema.optional<Schema.String>;
             readonly panelId: Schema.optional<Schema.String>;
+            readonly run: Schema.optional<Schema.declare<CapabilityRun, CapabilityRun>>;
         }>>>;
         readonly panels: Schema.optional<Schema.$Array<Schema.Struct<{
             readonly id: Schema.String;
@@ -424,6 +464,13 @@ export declare const RigPlugin: Schema.Struct<{
             readonly id: Schema.String;
             readonly description: Schema.optional<Schema.String>;
         }>>>;
+        readonly seedEntrypoints: Schema.optional<Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly description: Schema.optional<Schema.String>;
+            readonly basename: Schema.optional<Schema.String>;
+            readonly workerArg: Schema.optional<Schema.String>;
+            readonly insidePty: Schema.optional<Schema.Boolean>;
+        }>>>;
     }>>;
 }>;
 export type RigPlugin = typeof RigPlugin.Type;

package/dist/src/plugin.js

@@ -42,6 +42,11 @@ 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"]);
@@ -216,6 +221,7 @@ var JournalEvent = Schema3.Struct({
   at: IsoDateTime,
   payload: Schema3.Unknown
 });
+var PLACEMENT_RUN_TRANSPORT = makeCapabilityId("transport.placement-run");
 
 // packages/contracts/src/plugin.ts
 var ValidatorCategory = Schema4.Literals([
@@ -289,14 +295,19 @@ var CliCommandRegistration = Schema4.Struct({
   description: Schema4.optional(Schema4.String),
   usage: Schema4.optional(Schema4.String),
   aliases: Schema4.optional(Schema4.Array(Schema4.String)),
-  projectRequired: Schema4.optional(Schema4.Boolean)
+  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)
+  panelId: Schema4.optional(Schema4.String),
+  run: Schema4.optional(CapabilityRunSchema)
 });
 var PanelRegistration = Schema4.Struct({
   id: Schema4.String,
@@ -316,6 +327,13 @@ 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)),
@@ -330,7 +348,8 @@ var PluginContributes = Schema4.Struct({
   capabilities: Schema4.optional(Schema4.Array(ProductCapabilityRegistration)),
   panels: Schema4.optional(Schema4.Array(PanelRegistration)),
   blockerClassifiers: Schema4.optional(Schema4.Array(BlockerClassifierRegistration)),
-  sessionExtensions: Schema4.optional(Schema4.Array(SessionExtensionRegistration))
+  sessionExtensions: Schema4.optional(Schema4.Array(SessionExtensionRegistration)),
+  seedEntrypoints: Schema4.optional(Schema4.Array(SeedEntrypointRegistration))
 });
 var RigPlugin = Schema4.Struct({
   name: Schema4.String,
@@ -348,6 +367,7 @@ export {
   TaskFieldExtension,
   SkillRegistration,
   SessionExtensionRegistration,
+  SeedEntrypointRegistration,
   RigPlugin,
   RepoSourceRegistration,
   ProductCapabilityRegistration,
@@ -357,6 +377,7 @@ export {
   HookMatcher,
   HookEvent,
   CliCommandRegistration,
+  CapabilityRunSchema,
   BlockerClassifierRegistration,
   AgentSessionHookEvent,
   AgentRoleRegistration

package/dist/src/prompt.d.ts

@@ -0,0 +1,29 @@
+/**
+ * prompt.ts — pure capability vocabulary for agent prompt assembly.
+ *
+ * Moved here from `@rig/prompt-plugin` (where it was defined locally): the FLOOR
+ * cannot resolve a capability whose id/input type only exist inside a plugin
+ * without importing the plugin. The plugin OWNS the impl
+ * (`readPriorPrProgressPromptSection`, lazy-loaded inside `run()`) and registers
+ * it under this id; consumers resolve it off the host. Types only here.
+ */
+import type { CapabilityId } from "./capability-id";
+/**
+ * Capability id: agent prompt assembly — the prior-progress section of what the
+ * agent is told for a re-dispatched task.
+ */
+export declare const PRIOR_PROGRESS_PROMPT_CAPABILITY_ID = "prompt.prior-progress";
+/** Pure input: which workspace + task to assemble the prior-progress section for. */
+export type PriorProgressPromptInput = {
+    readonly projectRoot: string;
+    readonly taskId: string;
+};
+/**
+ * The cohesive prompt-assembly operation: returns the prior-PR-progress prompt
+ * section, or null when there is no prior progress. Async (reads fs).
+ */
+export interface PriorProgressPromptService {
+    readPriorProgressSection(input: PriorProgressPromptInput): Promise<string | null>;
+}
+/** Typed capability id; string value is {@link PRIOR_PROGRESS_PROMPT_CAPABILITY_ID}. */
+export declare const PRIOR_PROGRESS_PROMPT: CapabilityId<PriorProgressPromptService>;

package/dist/src/prompt.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/prompt.ts
+var PRIOR_PROGRESS_PROMPT_CAPABILITY_ID = "prompt.prior-progress";
+var PRIOR_PROGRESS_PROMPT = makeCapabilityId(PRIOR_PROGRESS_PROMPT_CAPABILITY_ID);
+export {
+  PRIOR_PROGRESS_PROMPT_CAPABILITY_ID,
+  PRIOR_PROGRESS_PROMPT
+};

package/dist/src/provider-instructions.d.ts

@@ -7,13 +7,35 @@
  * without a substrate->plugin import cycle. Carries no behaviour and imports
  * nothing — exactly like `memory.ts` / `lifecycle-capabilities.ts`.
  *
- * The plugin registers its executable `RuntimeInstructionService` impl under
- * {@link RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID} on
- * `contributes.capabilities[].run`; the runtime resolves it by id from
- * `pluginHost.listExecutableCapabilities()` via the typed port in
+ * The plugin registers its executable `RuntimeInstructionService` impl under the
+ * typed id {@link RUNTIME_INSTRUCTION} (whose string value is
+ * {@link RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID}) via `*.provide`; the runtime
+ * resolves it by id from `pluginHost.listExecutableCapabilities()` via the
+ * `defineCapability` seam (`@rig/core/capability`), re-exported from the thin
  * `@rig/runtime/control-plane/provider-instruction-port`.
  */
+import type { CapabilityId } from "./capability-id";
 /** Capability id the provider plugin registers its instruction service under. */
 export declare const RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID = "provider.runtime-instructions";
 /** The agent harness adapter the runtime is currently wired to. */
 export type RuntimeInstructionProvider = "pi";
+/**
+ * The cohesive set of agent-harness instruction builders the runtime consumers
+ * depend on. This is pure capability VOCAB: the `@rig/provider-plugin` provides a
+ * concrete impl (statically checked against this interface via the typed
+ * capability seam), and the substrate only ever sees this contract — resolved by
+ * id off a plugin host with no `as unknown as` at any call site.
+ */
+export interface RuntimeInstructionService {
+    normalizeProvider(value: string | undefined | null): RuntimeInstructionProvider;
+    buildTaskRunInstructionLines(provider: RuntimeInstructionProvider): string[];
+    buildRuntimeContextLines(provider: RuntimeInstructionProvider): string[];
+}
+/**
+ * The typed capability id the provider plugin provides and consumers require.
+ * Phantom-typed with `RuntimeInstructionService` so `resolve(host)` returns a
+ * `RuntimeInstructionService` with no cast leaking to callers. Its string value
+ * is {@link RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID}, so it indexes the same
+ * host entry.
+ */
+export declare const RUNTIME_INSTRUCTION: CapabilityId<RuntimeInstructionService>;

package/dist/src/provider-instructions.js

@@ -1,6 +1,13 @@
 // @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
 // packages/contracts/src/provider-instructions.ts
 var RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID = "provider.runtime-instructions";
+var RUNTIME_INSTRUCTION = makeCapabilityId(RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID);
 export {
-  RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID
+  RUNTIME_INSTRUCTION_SERVICE_CAPABILITY_ID,
+  RUNTIME_INSTRUCTION
 };