@gricha/perry 0.2.3 → 0.2.5

package/README.md

@@ -5,6 +5,7 @@
 <h1 align="center">Perry</h1>
 
 <p align="center">
+  <a href="https://gricha.github.io/perry/"><img src="https://img.shields.io/badge/docs-docusaurus-blue" alt="Documentation"></a>
   <a href="https://github.com/gricha/perry/actions/workflows/test.yml"><img src="https://github.com/gricha/perry/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
   <a href="https://github.com/gricha/perry/releases"><img src="https://img.shields.io/github/v/release/gricha/perry" alt="Release"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
@@ -28,6 +29,8 @@ It can be connected directly to your host, or it can create docker containers so
 
 Continue your sessions on the go!
 
+**[Get Started →](https://gricha.github.io/perry/docs/getting-started)**
+
 ## Features
 
 - **AI Coding Agents** - Claude Code, OpenCode, Codex CLI pre-installed

package/dist/agent/file-watcher.js

@@ -1,12 +1,8 @@
 import { watch } from 'fs';
 import { access } from 'fs/promises';
 import { expandPath } from '../config/loader';
-const STANDARD_CREDENTIAL_FILES = [
-    '~/.gitconfig',
-    '~/.claude/.credentials.json',
-    '~/.codex/auth.json',
-    '~/.codex/config.toml',
-];
+import { getCredentialFilePaths } from '../agents';
+const STANDARD_CREDENTIAL_FILES = ['~/.gitconfig', ...getCredentialFilePaths()];
 export class FileWatcher {
     watchers = new Map();
     config;

package/dist/agent/router.js

@@ -16,6 +16,7 @@ const WorkspaceStatusSchema = z.enum(['running', 'stopped', 'creating', 'error']
 const WorkspacePortsSchema = z.object({
     ssh: z.number(),
     http: z.number().optional(),
+    forwards: z.array(z.number()).optional(),
 });
 const WorkspaceInfoSchema = z.object({
     name: z.string(),
@@ -31,7 +32,8 @@ const CredentialsSchema = z.object({
     files: z.record(z.string(), z.string()),
 });
 const ScriptsSchema = z.object({
-    post_start: z.string().optional(),
+    post_start: z.array(z.string()).optional(),
+    fail_on_error: z.boolean().optional(),
 });
 const CodingAgentsSchema = z.object({
     opencode: z
@@ -193,6 +195,43 @@ export function createRouter(ctx) {
         }
         return workspace;
     });
+    const getPortForwards = os
+        .input(z.object({ name: z.string() }))
+        .output(z.object({ forwards: z.array(z.number()) }))
+        .handler(async ({ input }) => {
+        try {
+            const forwards = await ctx.workspaces.getPortForwards(input.name);
+            return { forwards };
+        }
+        catch (err) {
+            mapErrorToORPC(err, 'Failed to get port forwards');
+        }
+    });
+    const setPortForwards = os
+        .input(z.object({ name: z.string(), forwards: z.array(z.number().int().min(1).max(65535)) }))
+        .output(WorkspaceInfoSchema)
+        .handler(async ({ input }) => {
+        try {
+            return await ctx.workspaces.setPortForwards(input.name, input.forwards);
+        }
+        catch (err) {
+            mapErrorToORPC(err, 'Failed to set port forwards');
+        }
+    });
+    const cloneWorkspace = os
+        .input(z.object({
+        sourceName: z.string(),
+        cloneName: z.string(),
+    }))
+        .output(WorkspaceInfoSchema)
+        .handler(async ({ input }) => {
+        try {
+            return await ctx.workspaces.clone(input.sourceName, input.cloneName);
+        }
+        catch (err) {
+            mapErrorToORPC(err, 'Failed to clone workspace');
+        }
+    });
     const getInfo = os.handler(async () => {
         let dockerVersion = 'unknown';
         try {
@@ -275,6 +314,76 @@ export function createRouter(ctx) {
     const listSSHKeys = os.output(z.array(SSHKeyInfoSchema)).handler(async () => {
         return discoverSSHKeys();
     });
+    const GitHubRepoSchema = z.object({
+        name: z.string(),
+        fullName: z.string(),
+        cloneUrl: z.string(),
+        sshUrl: z.string(),
+        private: z.boolean(),
+        description: z.string().nullable(),
+        updatedAt: z.string(),
+    });
+    const listGitHubRepos = os
+        .input(z.object({
+        search: z.string().optional(),
+        perPage: z.number().optional().default(30),
+        page: z.number().optional().default(1),
+    }))
+        .output(z.object({
+        configured: z.boolean(),
+        repos: z.array(GitHubRepoSchema),
+        hasMore: z.boolean(),
+    }))
+        .handler(async ({ input }) => {
+        const config = ctx.config.get();
+        const token = config.agents?.github?.token;
+        if (!token) {
+            return { configured: false, repos: [], hasMore: false };
+        }
+        try {
+            const params = new URLSearchParams({
+                per_page: String(input.perPage),
+                page: String(input.page),
+                sort: 'updated',
+                direction: 'desc',
+            });
+            const url = input.search
+                ? `https://api.github.com/search/repositories?q=${encodeURIComponent(input.search)}+user:@me&${params}`
+                : `https://api.github.com/user/repos?${params}`;
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: 'application/vnd.github+json',
+                    'X-GitHub-Api-Version': '2022-11-28',
+                },
+            });
+            if (!response.ok) {
+                if (response.status === 401) {
+                    return { configured: false, repos: [], hasMore: false };
+                }
+                throw new Error(`GitHub API error: ${response.status}`);
+            }
+            const data = await response.json();
+            const items = input.search ? data.items : data;
+            const repos = items.map((repo) => ({
+                name: repo.name,
+                fullName: repo.full_name,
+                cloneUrl: repo.clone_url,
+                sshUrl: repo.ssh_url,
+                private: repo.private,
+                description: repo.description,
+                updatedAt: repo.updated_at,
+            }));
+            const linkHeader = response.headers.get('Link');
+            const hasMore = linkHeader?.includes('rel="next"') ?? false;
+            return { configured: true, repos, hasMore };
+        }
+        catch (err) {
+            throw new ORPCError('INTERNAL_SERVER_ERROR', {
+                message: `Failed to fetch GitHub repos: ${err.message}`,
+            });
+        }
+    });
     async function listHostSessions(input) {
         const limit = input.limit ?? 50;
         const offset = input.offset ?? 0;
@@ -777,20 +886,6 @@ export function createRouter(ctx) {
             homeDir: os_module.homedir(),
         };
     });
-    const updateHostAccess = os
-        .input(z.object({ enabled: z.boolean() }))
-        .handler(async ({ input }) => {
-        const currentConfig = ctx.config.get();
-        const newConfig = { ...currentConfig, allowHostAccess: input.enabled };
-        ctx.config.set(newConfig);
-        await saveAgentConfig(newConfig, ctx.configDir);
-        return {
-            enabled: input.enabled,
-            hostname: os_module.hostname(),
-            username: os_module.userInfo().username,
-            homeDir: os_module.homedir(),
-        };
-    });
     const listModels = os
         .input(z.object({
         agentType: z.enum(['claude-code', 'opencode']),
@@ -850,6 +945,7 @@ export function createRouter(ctx) {
             list: listWorkspaces,
             get: getWorkspace,
             create: createWorkspace,
+            clone: cloneWorkspace,
             delete: deleteWorkspace,
             start: startWorkspace,
             stop: stopWorkspace,
@@ -857,6 +953,8 @@ export function createRouter(ctx) {
             sync: syncWorkspace,
             syncAll: syncAllWorkspaces,
             touch: touchWorkspace,
+            getPortForwards: getPortForwards,
+            setPortForwards: setPortForwards,
         },
         sessions: {
             list: listSessions,
@@ -871,9 +969,11 @@ export function createRouter(ctx) {
         models: {
             list: listModels,
         },
+        github: {
+            listRepos: listGitHubRepos,
+        },
         host: {
             info: getHostInfo,
-            updateAccess: updateHostAccess,
         },
         info: getInfo,
         config: {

package/dist/agent/run.js

@@ -5,7 +5,7 @@ import { HOST_WORKSPACE_NAME } from '../shared/client-types';
 import { DEFAULT_AGENT_PORT } from '../shared/constants';
 import { WorkspaceManager } from '../workspace/manager';
 import { containerRunning, getContainerName } from '../docker';
-import { startEagerImagePull } from '../docker/eager-pull';
+import { startEagerImagePull, stopEagerImagePull } from '../docker/eager-pull';
 import { TerminalWebSocketServer } from '../terminal/websocket';
 import { ChatWebSocketServer } from '../chat/websocket';
 import { OpencodeWebSocketServer } from '../chat/opencode-websocket';
@@ -245,8 +245,20 @@ export async function startAgent(options = {}) {
         console.log(`[agent] WebSocket chat (OpenCode): ws://localhost:${port}/rpc/opencode/:name`);
         startEagerImagePull();
     });
+    let isShuttingDown = false;
     const shutdown = async () => {
+        if (isShuttingDown) {
+            console.log('[agent] Force exit');
+            process.exit(0);
+        }
+        isShuttingDown = true;
         console.log('[agent] Shutting down...');
+        const forceExitTimeout = setTimeout(() => {
+            console.log('[agent] Force exit after timeout');
+            process.exit(0);
+        }, 3000);
+        forceExitTimeout.unref();
+        stopEagerImagePull();
         fileWatcher.stop();
         if (tailscaleServeActive) {
             console.log('[agent] Stopping Tailscale Serve...');
@@ -255,7 +267,9 @@ export async function startAgent(options = {}) {
         chatServer.close();
         opencodeServer.close();
         terminalServer.close();
+        server.closeAllConnections();
         server.close(() => {
+            clearTimeout(forceExitTimeout);
             console.log('[agent] Server closed');
             process.exit(0);
         });