@pontia/pi-client-plugin 0.1.0 → 0.2.1

package/README.md

@@ -1,49 +1,41 @@
 # @pontia/pi-client-plugin
 
-Connect Pi coding-agent sessions to Pontia.
+Connect your pi coding-agent sessions to Pontia so you can follow and continue your work from the web dashboard.
 
 ## Requirements
 
 - [Pontia](https://pontia.dev/) running locally
-- Pi CLI
+- pi CLI
 - tmux
 
 ## Install
 
+If you selected the pi integration during `pontia init`, the plugin is already installed.
+
+To install it separately:
+
 ```bash
 pi install npm:@pontia/pi-client-plugin
 ```
 
-## Configure
-
-Set the Pi command in `$PONTIA_HOME/config.toml`:
+The plugin loads automatically when pi starts.
 
-```toml
-[runtime.pi]
-tui_command = "pi"
-```
-
-Then launch Pi from Pontia, or run it in a tmux pane inside a workspace registered with Pontia. The extension loads automatically.
+## Get started
 
-## Troubleshooting
+Open the Pontia dashboard and create a pi session. You can then view the session and continue the conversation from the dashboard.
 
-If a session does not appear in Pontia, verify that:
+You can also start pi in a tmux pane inside a workspace registered with Pontia.
 
-- Pontia is running
-- the current workspace is registered with Pontia
-- Pi is running inside tmux
+For Pontia installation and setup, see the [getting started guide](../../README.md#get-started).
 
-Extension logs are available at:
-
-```text
-${PONTIA_HOME:-$HOME/.pontia}/state/pi-hook.log
-```
+## Troubleshooting
 
-Follow the log while reproducing an issue:
+If a session does not appear in the dashboard, check that:
 
-```bash
-tail -f "${PONTIA_HOME:-$HOME/.pontia}/state/pi-hook.log"
-```
+- Pontia is running (`pontia status`).
+- The workspace is registered with Pontia.
+- pi is running inside tmux.
+- If you just installed the plugin, you have restarted pi.
 
 ## License
 

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@pontia/pi-client-plugin",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Pi extension that connects coding-agent sessions to Pontia.",
+  "keywords": [
+    "pi-package",
+    "pontia-client-plugin"
+  ],
+  "homepage": "https://pontia.dev/",
+  "bugs": {
+    "url": "https://github.com/anthod0/pontia/issues"
+  },
   "license": "Apache-2.0",
   "author": {
     "name": "anthod0",
@@ -12,39 +20,38 @@
     "url": "git+https://github.com/anthod0/pontia.git",
     "directory": "clients/pi"
   },
-  "homepage": "https://pontia.dev/",
-  "bugs": {
-    "url": "https://github.com/anthod0/pontia/issues"
-  },
-  "type": "module",
   "files": [
     "src",
     "README.md",
     "LICENSE"
   ],
+  "type": "module",
   "publishConfig": {
     "access": "public"
   },
-  "keywords": [
-    "pi-package",
-    "pontia-client-plugin"
-  ],
-  "pi": {
-    "extensions": [
-      "./src/index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*"
+  "scripts": {
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
+    "@earendil-works/pi-coding-agent": ">=0.86.1 <1",
     "@types/node": "^22.15.3",
+    "oxfmt": "^0.70.0",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2"
   },
-  "scripts": {
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.86.1 <1"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "trustedDependencies": [
+    "esbuild",
+    "koffi"
+  ]
+}

package/src/context.ts

@@ -1,6 +1,4 @@
 import { join } from "node:path";
-import { pontiaHomeFromEnv, resolvePontiaConnection } from "./discovery.js";
-import type { SessionContext } from "./session.js";
 
 export interface TurnContext {
   sessionId: string;
@@ -9,112 +7,10 @@ export interface TurnContext {
   input?: string;
   inboxMessageId?: string;
   clientType: "pi";
-  internalEventUrl: string;
 }
 
-export type LoadTurnContextResult =
-  | { ok: true; context: TurnContext; logFile: string }
-  | { ok: false; reason: string; logFile?: string; silent?: boolean };
-
 export type EnvLike = Record<string, string | undefined>;
 
-export interface LoadTurnContextOptions {
-  fetch?: typeof fetch;
-  sessionContext?: SessionContext;
-}
-
 export function defaultHookLogFile(pontiaHome: string): string {
   return join(pontiaHome, "state", "pi-hook.log");
 }
-
-function asRecord(value: unknown): Record<string, unknown> | undefined {
-  return value && typeof value === "object" && !Array.isArray(value) ? (value as Record<string, unknown>) : undefined;
-}
-
-function optionalString(value: unknown): string | undefined {
-  return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-
-function claimUrl(internalEventUrl: string, sessionId: string): string | undefined {
-  try {
-    const url = new URL(internalEventUrl);
-    url.pathname = url.pathname.replace(/\/events\/?$/, `/sessions/${encodeURIComponent(sessionId)}/current-turn/claim`);
-    return url.toString();
-  } catch {
-    return undefined;
-  }
-}
-
-function contextFromRecord(record: Record<string, unknown>, logFile: string, discoveredInternalEventUrl?: string): LoadTurnContextResult {
-  const errors: string[] = [];
-  const sessionId = optionalString(record.session_id);
-  const turnId = optionalString(record.turn_id);
-  const clientType = optionalString(record.client_type);
-  const internalEventUrl = optionalString(record.internal_event_url) ?? discoveredInternalEventUrl;
-  const runtimeInstanceId = optionalString(record.runtime_instance_id);
-  const input = optionalString(record.input);
-  const inboxMessageId = optionalString(record.inbox_message_id);
-
-  if (!sessionId) errors.push("session_id is required");
-  if (clientType !== "pi") errors.push("client_type must be pi");
-  if (!internalEventUrl) errors.push("internal_event_url or pontia connection from PONTIA_HOME/config.toml is required");
-  if (!runtimeInstanceId) errors.push("runtime_instance_id is required");
-
-  if (errors.length > 0) {
-    return { ok: false, reason: errors.join("; "), logFile };
-  }
-
-  return {
-    ok: true,
-    logFile,
-    context: {
-      sessionId: sessionId!,
-      turnId,
-      runtimeInstanceId: runtimeInstanceId!,
-      input,
-      inboxMessageId,
-      clientType: "pi",
-      internalEventUrl: internalEventUrl!,
-    },
-  };
-}
-
-async function claimTurnContext(
-  pontiaHome: string,
-  logFile: string,
-  fetchImpl: typeof fetch,
-  sessionContext?: SessionContext,
-): Promise<LoadTurnContextResult | undefined> {
-  if (!sessionContext) return undefined;
-  const connection = await resolvePontiaConnection({ pontiaHome, fetch: fetchImpl });
-  const internalEventUrl = sessionContext.internalEventUrl ?? connection?.internalEventUrl;
-  const url = claimUrl(internalEventUrl, sessionContext.sessionId);
-  if (!url) return undefined;
-
-  try {
-    const response = await fetchImpl(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ runtime_instance_id: sessionContext.runtimeInstanceId, client_type: "pi" }),
-    });
-    if (!response.ok) return undefined;
-    const body = (await response.json()) as unknown;
-    const data = asRecord(body)?.data;
-    const currentTurn = asRecord(asRecord(data)?.current_turn);
-    if (!currentTurn) return { ok: false, reason: "no pending current turn", logFile, silent: true };
-    return contextFromRecord(currentTurn, logFile, internalEventUrl);
-  } catch {
-    return undefined;
-  }
-}
-
-export async function loadTurnContext(env: EnvLike = process.env, options: LoadTurnContextOptions = {}): Promise<LoadTurnContextResult> {
-  const pontiaHome = pontiaHomeFromEnv(env);
-  if (!pontiaHome) {
-    return { ok: false, reason: "Pontia home must resolve to a non-root absolute path", silent: true };
-  }
-  const logFile = defaultHookLogFile(pontiaHome);
-  const claimed = await claimTurnContext(pontiaHome, logFile, options.fetch ?? fetch, options.sessionContext);
-  if (claimed) return claimed;
-  return { ok: false, reason: "current turn claim unavailable", logFile, silent: true };
-}