@h-rig/pi-rig 0.0.6-alpha.0

package/README.md

@@ -0,0 +1 @@
+# @h-rig/pi-rig

package/dist/src/client.js

@@ -0,0 +1,194 @@
+// @bun
+// packages/pi-rig/src/client.ts
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, resolve } from "path";
+function cleanString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readJson(path) {
+  if (!existsSync(path))
+    return null;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function findRigProjectRoot(cwd) {
+  let current = resolve(cwd);
+  while (true) {
+    if (existsSync(resolve(current, ".rig", "state", "connection.json")) || existsSync(resolve(current, "rig.config.ts")) || existsSync(resolve(current, "rig.config.json"))) {
+      return current;
+    }
+    const parent = dirname(current);
+    if (parent === current)
+      return null;
+    current = parent;
+  }
+}
+function resolveGlobalConnectionsPath(env) {
+  const explicit = cleanString(env.RIG_CONNECTIONS_FILE);
+  if (explicit)
+    return resolve(explicit);
+  const stateDir = cleanString(env.RIG_GLOBAL_STATE_DIR);
+  if (stateDir)
+    return resolve(stateDir, "connections.json");
+  return resolve(homedir(), ".rig", "connections.json");
+}
+function discoverRigContext(env) {
+  const cwd = cleanString(env.PWD) ?? process.cwd();
+  const projectRoot = findRigProjectRoot(cwd);
+  if (!projectRoot)
+    return {};
+  const repoConnection = readJson(resolve(projectRoot, ".rig", "state", "connection.json"));
+  const selected = cleanString(repoConnection?.selected);
+  if (!selected)
+    return { projectRoot };
+  if (selected === "local") {
+    const server = readJson(resolve(projectRoot, ".rig", "state", "rig-server.json"));
+    const host = cleanString(server?.host);
+    const port = typeof server?.port === "number" ? server.port : null;
+    const authToken = cleanString(server?.authToken);
+    return {
+      projectRoot,
+      ...host && port ? { serverUrl: `http://${host}:${port}` } : {},
+      ...authToken ? { authToken } : {}
+    };
+  }
+  const global = readJson(resolveGlobalConnectionsPath(env));
+  const connections = global?.connections && typeof global.connections === "object" && !Array.isArray(global.connections) ? global.connections : {};
+  const selectedConnection = connections[selected];
+  const record = selectedConnection && typeof selectedConnection === "object" && !Array.isArray(selectedConnection) ? selectedConnection : null;
+  const baseUrl = record?.kind === "remote" ? cleanString(record.baseUrl) : null;
+  return { projectRoot, ...baseUrl ? { serverUrl: baseUrl } : {} };
+}
+function createRigContextFromEnv(env = process.env) {
+  const runId = env.RIG_RUN_ID ?? env.RIG_SERVER_RUN_ID;
+  const taskId = env.RIG_TASK_ID;
+  const discovered = discoverRigContext(env);
+  const serverUrl = env.RIG_SERVER_URL ?? env.RIG_SERVER_BASE_URL ?? discovered.serverUrl;
+  const projectRoot = env.RIG_PROJECT_ROOT ?? env.PROJECT_RIG_ROOT ?? discovered.projectRoot;
+  const authToken = env.RIG_AUTH_TOKEN ?? env.RIG_GITHUB_TOKEN ?? env.GITHUB_TOKEN ?? env.GH_TOKEN ?? discovered.authToken;
+  const active = Boolean(runId || taskId || serverUrl || projectRoot);
+  if (!active)
+    return { active: false };
+  return {
+    active: true,
+    ...runId ? { runId } : {},
+    ...taskId ? { taskId } : {},
+    ...serverUrl ? { serverUrl } : {},
+    ...projectRoot ? { projectRoot } : {},
+    ...authToken ? { authToken } : {}
+  };
+}
+function joinUrl(baseUrl, pathname) {
+  return `${baseUrl.replace(/\/+$/, "")}${pathname.startsWith("/") ? pathname : `/${pathname}`}`;
+}
+async function readJsonResponse(response) {
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`Rig server request failed (${response.status}): ${text || response.statusText}`);
+  }
+  if (!text.trim())
+    return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function requireServerUrl(context) {
+  if (!context.serverUrl) {
+    throw new Error("Rig server URL is not available in this Pi session. Set RIG_SERVER_URL or start Pi through Rig.");
+  }
+  return context.serverUrl;
+}
+
+class RigBridgeClient {
+  context;
+  fetchImpl;
+  constructor(input) {
+    this.context = input.context;
+    this.fetchImpl = input.fetchImpl ?? fetch;
+  }
+  async request(pathname, init) {
+    const headers = new Headers(init?.headers);
+    if (this.context.authToken && !headers.has("authorization")) {
+      headers.set("authorization", `Bearer ${this.context.authToken}`);
+    }
+    const response = await this.fetchImpl(joinUrl(requireServerUrl(this.context), pathname), { ...init, headers });
+    return readJsonResponse(response);
+  }
+  async status() {
+    const payload = await this.request("/api/server/status");
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  }
+  async listTasks() {
+    const payload = await this.request("/api/workspace/tasks");
+    return Array.isArray(payload) ? payload.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async runTask(taskId) {
+    const endpoint = taskId ? "/api/runs/task" : "/api/runs/adhoc";
+    const body = taskId ? { taskId, runtimeAdapter: "pi", runtimeMode: "full-access", interactionMode: "default" } : { title: "Pi Rig ad-hoc run", runtimeAdapter: "pi", runtimeMode: "full-access", interactionMode: "default", initialPrompt: "Continue with the selected Rig task." };
+    const payload = await this.request(endpoint, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    const runId = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.runId : null;
+    return { runId: typeof runId === "string" ? runId : "" };
+  }
+  async attach(runId = this.context.runId) {
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}`);
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { runId };
+  }
+  async steer(message, runId = this.context.runId) {
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steer`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ message, actor: "pi" })
+    });
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true };
+  }
+  async pollSteering(runId = this.context.runId) {
+    if (!runId)
+      return [];
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steering`);
+    const messages = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.messages : null;
+    return Array.isArray(messages) ? messages.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async consumeSteering(runId = this.context.runId) {
+    if (!runId)
+      return [];
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steering?ack=1`);
+    const messages = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.messages : null;
+    return Array.isArray(messages) ? messages.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async emitEvent(event) {
+    const runId = typeof event.runId === "string" ? event.runId : this.context.runId;
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/events`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(event)
+    });
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true };
+  }
+  async readTaskMetadata(taskId = this.context.taskId) {
+    if (!taskId)
+      return {};
+    const payload = await this.request(`/api/workspace/tasks/${encodeURIComponent(taskId)}`);
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  }
+}
+export {
+  createRigContextFromEnv,
+  RigBridgeClient
+};

package/dist/src/commands.js

@@ -0,0 +1,49 @@
+// @bun
+// packages/pi-rig/src/commands.ts
+function createRigSlashCommands(input) {
+  const notify = input.notify ?? (() => {});
+  async function handleRig(args) {
+    const parts = args.trim().split(/\s+/).filter(Boolean);
+    const [first, second, third] = parts;
+    try {
+      if (!first || first === "status") {
+        const status = await input.client.status();
+        notify(`Rig server: ${status.ok === false ? "failed" : "ok"}`, "info");
+        return;
+      }
+      if (first === "task" && second === "list") {
+        const tasks = await input.client.listTasks();
+        if (tasks.length === 0) {
+          notify("No matching Rig tasks.", "info");
+          return;
+        }
+        notify(tasks.map((task) => `${String(task.id ?? "<unknown>")} \xB7 ${String(task.status ?? "unknown")} \xB7 ${String(task.title ?? "Untitled task")}`).join(`
+`), "info");
+        return;
+      }
+      if (first === "task" && second === "run") {
+        const result = await input.client.runTask(third);
+        notify(`Run submitted: ${result.runId}`, "info");
+        return;
+      }
+      if (first === "attach") {
+        const run = await input.client.attach(second);
+        const runRecord = run.run && typeof run.run === "object" ? run.run : run;
+        notify(`Attached to ${String(runRecord.runId ?? second ?? input.context.runId ?? "run")}: ${String(runRecord.status ?? "unknown")}`, "info");
+        return;
+      }
+      notify("Usage: /rig status | /rig task list | /rig task run [id] | /rig attach [run-id]", "error");
+    } catch (error) {
+      notify(error instanceof Error ? error.message : String(error), "error");
+    }
+  }
+  return {
+    rig: {
+      description: "Rig control-plane commands: status, task list, task run, attach",
+      handler: handleRig
+    }
+  };
+}
+export {
+  createRigSlashCommands
+};

package/dist/src/index.js

@@ -0,0 +1,378 @@
+// @bun
+// packages/pi-rig/src/client.ts
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, resolve } from "path";
+function cleanString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readJson(path) {
+  if (!existsSync(path))
+    return null;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function findRigProjectRoot(cwd) {
+  let current = resolve(cwd);
+  while (true) {
+    if (existsSync(resolve(current, ".rig", "state", "connection.json")) || existsSync(resolve(current, "rig.config.ts")) || existsSync(resolve(current, "rig.config.json"))) {
+      return current;
+    }
+    const parent = dirname(current);
+    if (parent === current)
+      return null;
+    current = parent;
+  }
+}
+function resolveGlobalConnectionsPath(env) {
+  const explicit = cleanString(env.RIG_CONNECTIONS_FILE);
+  if (explicit)
+    return resolve(explicit);
+  const stateDir = cleanString(env.RIG_GLOBAL_STATE_DIR);
+  if (stateDir)
+    return resolve(stateDir, "connections.json");
+  return resolve(homedir(), ".rig", "connections.json");
+}
+function discoverRigContext(env) {
+  const cwd = cleanString(env.PWD) ?? process.cwd();
+  const projectRoot = findRigProjectRoot(cwd);
+  if (!projectRoot)
+    return {};
+  const repoConnection = readJson(resolve(projectRoot, ".rig", "state", "connection.json"));
+  const selected = cleanString(repoConnection?.selected);
+  if (!selected)
+    return { projectRoot };
+  if (selected === "local") {
+    const server = readJson(resolve(projectRoot, ".rig", "state", "rig-server.json"));
+    const host = cleanString(server?.host);
+    const port = typeof server?.port === "number" ? server.port : null;
+    const authToken = cleanString(server?.authToken);
+    return {
+      projectRoot,
+      ...host && port ? { serverUrl: `http://${host}:${port}` } : {},
+      ...authToken ? { authToken } : {}
+    };
+  }
+  const global = readJson(resolveGlobalConnectionsPath(env));
+  const connections = global?.connections && typeof global.connections === "object" && !Array.isArray(global.connections) ? global.connections : {};
+  const selectedConnection = connections[selected];
+  const record = selectedConnection && typeof selectedConnection === "object" && !Array.isArray(selectedConnection) ? selectedConnection : null;
+  const baseUrl = record?.kind === "remote" ? cleanString(record.baseUrl) : null;
+  return { projectRoot, ...baseUrl ? { serverUrl: baseUrl } : {} };
+}
+function createRigContextFromEnv(env = process.env) {
+  const runId = env.RIG_RUN_ID ?? env.RIG_SERVER_RUN_ID;
+  const taskId = env.RIG_TASK_ID;
+  const discovered = discoverRigContext(env);
+  const serverUrl = env.RIG_SERVER_URL ?? env.RIG_SERVER_BASE_URL ?? discovered.serverUrl;
+  const projectRoot = env.RIG_PROJECT_ROOT ?? env.PROJECT_RIG_ROOT ?? discovered.projectRoot;
+  const authToken = env.RIG_AUTH_TOKEN ?? env.RIG_GITHUB_TOKEN ?? env.GITHUB_TOKEN ?? env.GH_TOKEN ?? discovered.authToken;
+  const active = Boolean(runId || taskId || serverUrl || projectRoot);
+  if (!active)
+    return { active: false };
+  return {
+    active: true,
+    ...runId ? { runId } : {},
+    ...taskId ? { taskId } : {},
+    ...serverUrl ? { serverUrl } : {},
+    ...projectRoot ? { projectRoot } : {},
+    ...authToken ? { authToken } : {}
+  };
+}
+function joinUrl(baseUrl, pathname) {
+  return `${baseUrl.replace(/\/+$/, "")}${pathname.startsWith("/") ? pathname : `/${pathname}`}`;
+}
+async function readJsonResponse(response) {
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`Rig server request failed (${response.status}): ${text || response.statusText}`);
+  }
+  if (!text.trim())
+    return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function requireServerUrl(context) {
+  if (!context.serverUrl) {
+    throw new Error("Rig server URL is not available in this Pi session. Set RIG_SERVER_URL or start Pi through Rig.");
+  }
+  return context.serverUrl;
+}
+
+class RigBridgeClient {
+  context;
+  fetchImpl;
+  constructor(input) {
+    this.context = input.context;
+    this.fetchImpl = input.fetchImpl ?? fetch;
+  }
+  async request(pathname, init) {
+    const headers = new Headers(init?.headers);
+    if (this.context.authToken && !headers.has("authorization")) {
+      headers.set("authorization", `Bearer ${this.context.authToken}`);
+    }
+    const response = await this.fetchImpl(joinUrl(requireServerUrl(this.context), pathname), { ...init, headers });
+    return readJsonResponse(response);
+  }
+  async status() {
+    const payload = await this.request("/api/server/status");
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  }
+  async listTasks() {
+    const payload = await this.request("/api/workspace/tasks");
+    return Array.isArray(payload) ? payload.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async runTask(taskId) {
+    const endpoint = taskId ? "/api/runs/task" : "/api/runs/adhoc";
+    const body = taskId ? { taskId, runtimeAdapter: "pi", runtimeMode: "full-access", interactionMode: "default" } : { title: "Pi Rig ad-hoc run", runtimeAdapter: "pi", runtimeMode: "full-access", interactionMode: "default", initialPrompt: "Continue with the selected Rig task." };
+    const payload = await this.request(endpoint, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    const runId = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.runId : null;
+    return { runId: typeof runId === "string" ? runId : "" };
+  }
+  async attach(runId = this.context.runId) {
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}`);
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { runId };
+  }
+  async steer(message, runId = this.context.runId) {
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steer`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ message, actor: "pi" })
+    });
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true };
+  }
+  async pollSteering(runId = this.context.runId) {
+    if (!runId)
+      return [];
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steering`);
+    const messages = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.messages : null;
+    return Array.isArray(messages) ? messages.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async consumeSteering(runId = this.context.runId) {
+    if (!runId)
+      return [];
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/steering?ack=1`);
+    const messages = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.messages : null;
+    return Array.isArray(messages) ? messages.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
+  }
+  async emitEvent(event) {
+    const runId = typeof event.runId === "string" ? event.runId : this.context.runId;
+    if (!runId)
+      throw new Error("runId is required");
+    const payload = await this.request(`/api/runs/${encodeURIComponent(runId)}/events`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(event)
+    });
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true };
+  }
+  async readTaskMetadata(taskId = this.context.taskId) {
+    if (!taskId)
+      return {};
+    const payload = await this.request(`/api/workspace/tasks/${encodeURIComponent(taskId)}`);
+    return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  }
+}
+
+// packages/pi-rig/src/commands.ts
+function createRigSlashCommands(input) {
+  const notify = input.notify ?? (() => {});
+  async function handleRig(args) {
+    const parts = args.trim().split(/\s+/).filter(Boolean);
+    const [first, second, third] = parts;
+    try {
+      if (!first || first === "status") {
+        const status = await input.client.status();
+        notify(`Rig server: ${status.ok === false ? "failed" : "ok"}`, "info");
+        return;
+      }
+      if (first === "task" && second === "list") {
+        const tasks = await input.client.listTasks();
+        if (tasks.length === 0) {
+          notify("No matching Rig tasks.", "info");
+          return;
+        }
+        notify(tasks.map((task) => `${String(task.id ?? "<unknown>")} \xB7 ${String(task.status ?? "unknown")} \xB7 ${String(task.title ?? "Untitled task")}`).join(`
+`), "info");
+        return;
+      }
+      if (first === "task" && second === "run") {
+        const result = await input.client.runTask(third);
+        notify(`Run submitted: ${result.runId}`, "info");
+        return;
+      }
+      if (first === "attach") {
+        const run = await input.client.attach(second);
+        const runRecord = run.run && typeof run.run === "object" ? run.run : run;
+        notify(`Attached to ${String(runRecord.runId ?? second ?? input.context.runId ?? "run")}: ${String(runRecord.status ?? "unknown")}`, "info");
+        return;
+      }
+      notify("Usage: /rig status | /rig task list | /rig task run [id] | /rig attach [run-id]", "error");
+    } catch (error) {
+      notify(error instanceof Error ? error.message : String(error), "error");
+    }
+  }
+  return {
+    rig: {
+      description: "Rig control-plane commands: status, task list, task run, attach",
+      handler: handleRig
+    }
+  };
+}
+
+// packages/pi-rig/src/tools.ts
+function textResult(text, details) {
+  return { content: [{ type: "text", text }], ...details ? { details } : {} };
+}
+function createRigTools(input) {
+  const runId = input.context.runId;
+  const taskId = input.context.taskId;
+  return [
+    {
+      name: "rig_status_update",
+      label: "Rig status update",
+      description: "Report a concise status update for the active Rig run.",
+      parameters: { type: "object", properties: { status: { type: "string" }, message: { type: "string" } }, required: ["message"] },
+      async execute(_toolCallId, params) {
+        const message = typeof params.message === "string" ? params.message : "Status updated";
+        const status = typeof params.status === "string" ? params.status : "running";
+        await input.client.emitEvent({ kind: "status", runId, taskId, status, message, createdAt: new Date().toISOString() });
+        return textResult(`Rig status updated: ${message}`);
+      }
+    },
+    {
+      name: "rig_artifact_write",
+      label: "Rig artifact write",
+      description: "Write an artifact for the active Rig run through the Rig bridge.",
+      parameters: { type: "object", properties: { filename: { type: "string" }, content: { type: "string" } }, required: ["filename", "content"] },
+      async execute(_toolCallId, params) {
+        const filename = typeof params.filename === "string" ? params.filename : "artifact.txt";
+        const content = typeof params.content === "string" ? params.content : "";
+        await input.client.emitEvent({ kind: "artifact", runId, taskId, filename, content, createdAt: new Date().toISOString() });
+        return textResult(`Rig artifact queued: ${filename}`);
+      }
+    },
+    {
+      name: "rig_task_metadata_read",
+      label: "Rig task metadata read",
+      description: "Read normalized Rig task metadata for the active task.",
+      parameters: { type: "object", properties: { taskId: { type: "string" } } },
+      async execute(_toolCallId, params) {
+        const metadata = await input.client.readTaskMetadata(typeof params.taskId === "string" ? params.taskId : taskId);
+        return textResult(JSON.stringify(metadata, null, 2), metadata);
+      }
+    },
+    {
+      name: "rig_task_metadata_update",
+      label: "Rig task metadata update",
+      description: "Queue a Rig-owned task metadata update event.",
+      parameters: { type: "object", properties: { taskId: { type: "string" }, metadata: { type: "object" } }, required: ["metadata"] },
+      async execute(_toolCallId, params) {
+        const targetTaskId = typeof params.taskId === "string" ? params.taskId : taskId;
+        const metadata = params.metadata && typeof params.metadata === "object" && !Array.isArray(params.metadata) ? params.metadata : {};
+        await input.client.emitEvent({ kind: "task-metadata", runId, taskId: targetTaskId, metadata, createdAt: new Date().toISOString() });
+        return textResult(`Rig task metadata update queued for ${targetTaskId ?? "active task"}.`);
+      }
+    }
+  ];
+}
+
+// packages/pi-rig/src/index.ts
+function createPiRigExtensionState(input = {}) {
+  const context = createRigContextFromEnv(input.env ?? process.env);
+  return {
+    ...context,
+    client: new RigBridgeClient({ context, fetchImpl: input.fetchImpl })
+  };
+}
+function notify(ctx, message, level = "info") {
+  const ui = ctx && typeof ctx === "object" ? ctx.ui : null;
+  const notifyFn = ui && typeof ui === "object" ? ui.notify : null;
+  if (typeof notifyFn === "function") {
+    notifyFn.call(ui, message, level);
+  }
+}
+function steeringText(message) {
+  const text = typeof message.message === "string" ? message.message.trim() : "";
+  if (!text)
+    return null;
+  const actor = typeof message.actor === "string" && message.actor.trim() ? message.actor.trim() : "operator";
+  return `[Rig steering from ${actor}]
+${text}`;
+}
+async function consumeQueuedSteering(pi, state, ctx) {
+  if (!state.active || !state.runId || typeof pi.sendUserMessage !== "function")
+    return;
+  try {
+    const messages = await state.client.consumeSteering(state.runId);
+    for (const message of messages) {
+      const text = steeringText(message);
+      if (!text)
+        continue;
+      await pi.sendUserMessage(text, { deliverAs: "steer", triggerTurn: true });
+    }
+    if (messages.length > 0) {
+      notify(ctx, `Delivered ${messages.length} Rig steering message${messages.length === 1 ? "" : "s"}.`);
+    }
+  } catch (error) {
+    notify(ctx, `Rig steering sync failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+  }
+}
+function createPiRigExtension(pi, options = {}) {
+  const state = options.state ?? createPiRigExtensionState();
+  const commands = createRigSlashCommands({
+    context: state,
+    client: state.client,
+    notify: (message, level) => notify(globalThis, message, level)
+  });
+  for (const [name, command] of Object.entries(commands)) {
+    pi.registerCommand?.(name, {
+      description: command.description,
+      handler: async (args, ctx) => {
+        const nextCommands = createRigSlashCommands({
+          context: state,
+          client: state.client,
+          notify: (message, level) => notify(ctx, message, level)
+        });
+        await nextCommands.rig.handler(args, ctx);
+      }
+    });
+  }
+  if (state.active && state.runId) {
+    for (const tool of createRigTools({ context: state, client: state.client })) {
+      pi.registerTool?.(tool);
+    }
+  }
+  pi.on?.("session_start", async (_event, ctx) => {
+    if (!state.active || !state.runId)
+      return;
+    const ui = ctx && typeof ctx === "object" ? ctx.ui : null;
+    const setStatus = ui && typeof ui === "object" ? ui.setStatus : null;
+    if (typeof setStatus === "function") {
+      setStatus.call(ui, "rig", `Rig ${state.runId}`);
+    }
+    await consumeQueuedSteering(pi, state, ctx);
+  });
+  pi.on?.("turn_end", async (_event, ctx) => {
+    await consumeQueuedSteering(pi, state, ctx);
+  });
+}
+export {
+  createPiRigExtension as default,
+  createPiRigExtensionState
+};

package/dist/src/tools.js

@@ -0,0 +1,60 @@
+// @bun
+// packages/pi-rig/src/tools.ts
+function textResult(text, details) {
+  return { content: [{ type: "text", text }], ...details ? { details } : {} };
+}
+function createRigTools(input) {
+  const runId = input.context.runId;
+  const taskId = input.context.taskId;
+  return [
+    {
+      name: "rig_status_update",
+      label: "Rig status update",
+      description: "Report a concise status update for the active Rig run.",
+      parameters: { type: "object", properties: { status: { type: "string" }, message: { type: "string" } }, required: ["message"] },
+      async execute(_toolCallId, params) {
+        const message = typeof params.message === "string" ? params.message : "Status updated";
+        const status = typeof params.status === "string" ? params.status : "running";
+        await input.client.emitEvent({ kind: "status", runId, taskId, status, message, createdAt: new Date().toISOString() });
+        return textResult(`Rig status updated: ${message}`);
+      }
+    },
+    {
+      name: "rig_artifact_write",
+      label: "Rig artifact write",
+      description: "Write an artifact for the active Rig run through the Rig bridge.",
+      parameters: { type: "object", properties: { filename: { type: "string" }, content: { type: "string" } }, required: ["filename", "content"] },
+      async execute(_toolCallId, params) {
+        const filename = typeof params.filename === "string" ? params.filename : "artifact.txt";
+        const content = typeof params.content === "string" ? params.content : "";
+        await input.client.emitEvent({ kind: "artifact", runId, taskId, filename, content, createdAt: new Date().toISOString() });
+        return textResult(`Rig artifact queued: ${filename}`);
+      }
+    },
+    {
+      name: "rig_task_metadata_read",
+      label: "Rig task metadata read",
+      description: "Read normalized Rig task metadata for the active task.",
+      parameters: { type: "object", properties: { taskId: { type: "string" } } },
+      async execute(_toolCallId, params) {
+        const metadata = await input.client.readTaskMetadata(typeof params.taskId === "string" ? params.taskId : taskId);
+        return textResult(JSON.stringify(metadata, null, 2), metadata);
+      }
+    },
+    {
+      name: "rig_task_metadata_update",
+      label: "Rig task metadata update",
+      description: "Queue a Rig-owned task metadata update event.",
+      parameters: { type: "object", properties: { taskId: { type: "string" }, metadata: { type: "object" } }, required: ["metadata"] },
+      async execute(_toolCallId, params) {
+        const targetTaskId = typeof params.taskId === "string" ? params.taskId : taskId;
+        const metadata = params.metadata && typeof params.metadata === "object" && !Array.isArray(params.metadata) ? params.metadata : {};
+        await input.client.emitEvent({ kind: "task-metadata", runId, taskId: targetTaskId, metadata, createdAt: new Date().toISOString() });
+        return textResult(`Rig task metadata update queued for ${targetTaskId ?? "active task"}.`);
+      }
+    }
+  ];
+}
+export {
+  createRigTools
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@h-rig/pi-rig",
+  "version": "0.0.6-alpha.0",
+  "type": "module",
+  "description": "Rig package",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js"
+    },
+    "./client": {
+      "import": "./dist/src/client.js"
+    },
+    "./commands": {
+      "import": "./dist/src/commands.js"
+    },
+    "./tools": {
+      "import": "./dist/src/tools.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "pi": {
+    "extensions": [
+      "./dist/src/index.js"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  }
+}