@parall/claude-agent 1.15.1

package/src/session-manager.ts

@@ -0,0 +1,87 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+import type { ForkSessionHandle } from "@parall/agent-core";
+
+type PersistedMainSession = {
+  runtimeKey: string;
+  sessionId: string;
+};
+
+type ClaudeSessionManagerLogger = {
+  warn(message: string): void;
+};
+
+export class ClaudeSessionManager {
+  private readonly sessionIds = new Map<string, string>();
+  private readonly pendingForkParents = new Map<string, string>();
+
+  constructor(
+    private readonly mainSessionKey: string,
+    private readonly stateFilePath: string,
+    private readonly logger?: ClaudeSessionManagerLogger,
+  ) {
+    this.restore();
+  }
+
+  getResumeArgs(sessionKey: string): string[] {
+    const existing = this.sessionIds.get(sessionKey);
+    if (existing) return ["--resume", existing];
+
+    const parent = this.pendingForkParents.get(sessionKey);
+    if (parent) return ["--resume", parent, "--fork-session"];
+
+    return [];
+  }
+
+  recordSessionId(sessionKey: string, sessionId: string) {
+    this.sessionIds.set(sessionKey, sessionId);
+    this.pendingForkParents.delete(sessionKey);
+    if (sessionKey === this.mainSessionKey) {
+      this.persist(sessionId);
+    }
+  }
+
+  createForkSession(parentSessionKey: string): ForkSessionHandle | null {
+    const parentSessionId = this.sessionIds.get(parentSessionKey);
+    if (!parentSessionId) return null;
+
+    const sessionKey = `claude-fork:${randomUUID()}`;
+    this.pendingForkParents.set(sessionKey, parentSessionId);
+    return {
+      sessionKey,
+      parentSessionId,
+    };
+  }
+
+  cleanupFork(sessionKey: string) {
+    this.pendingForkParents.delete(sessionKey);
+    this.sessionIds.delete(sessionKey);
+  }
+
+  private restore() {
+    try {
+      const raw = fs.readFileSync(this.stateFilePath, "utf8");
+      const parsed = JSON.parse(raw) as Partial<PersistedMainSession>;
+      if (parsed.runtimeKey === this.mainSessionKey && typeof parsed.sessionId === "string" && parsed.sessionId.trim()) {
+        this.sessionIds.set(this.mainSessionKey, parsed.sessionId.trim());
+      }
+    } catch {
+      // No persisted main session yet.
+    }
+  }
+
+  private persist(sessionId: string) {
+    try {
+      fs.mkdirSync(path.dirname(this.stateFilePath), { recursive: true });
+      fs.writeFileSync(this.stateFilePath, JSON.stringify({
+        runtimeKey: this.mainSessionKey,
+        sessionId,
+      }, null, 2));
+    } catch (error) {
+      this.logger?.warn(
+        `claude-agent: failed to persist main session state at ${this.stateFilePath}: ${String(error)}`,
+      );
+    }
+  }
+}

package/src/workspace.ts

@@ -0,0 +1,39 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const CLAUDE_MD = `# CLAUDE.md
+
+You are an agent in Parall IM. You participate in chats, handle tasks, and can use Parall CLI commands for advanced operations.
+
+## Message Model
+
+Incoming events are rendered as structured \`[Event: ...]\` blocks.
+Reply with plain text when you want Parall to project your response back into the triggering chat.
+
+## Parall CLI
+
+Use CLI only when you need an explicit side effect instead of plain-text projection:
+
+- \`npx @parall/cli@latest messages send CHT_ID --text "..." \`
+- \`npx @parall/cli@latest tasks update TSK_ID --status in_progress\`
+- \`npx @parall/cli@latest dm USER_ID --text "..." --no-reply\`
+
+Credentials are already injected through environment variables:
+\`PRLL_API_URL\`, \`PRLL_API_KEY\`, \`PRLL_ORG_ID\`, \`PRLL_SESSION_ID\`, \`PRLL_CHAT_ID\`, \`PRLL_TRIGGER_MESSAGE_ID\`, \`PRLL_STEP_ID_FILE\`.
+
+## Guardrails
+
+- If an event includes \`[Hint: no_reply]\`, do not send a reply.
+- Prefer plain text over CLI for normal chat replies.
+- Keep replies concise and task-focused.
+`;
+
+export function ensureClaudeWorkspace(workspaceDir: string) {
+  fs.mkdirSync(workspaceDir, { recursive: true });
+  fs.mkdirSync(path.join(workspaceDir, ".claude"), { recursive: true });
+
+  const claudeMdPath = path.join(workspaceDir, "CLAUDE.md");
+  if (!fs.existsSync(claudeMdPath)) {
+    fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
+  }
+}