pennyrouter 0.3.50 → 0.3.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,167 +0,0 @@
1
- """Experimental Penny project launcher with phone Read/Edit approvals and Stop.
2
-
3
- Sessions persist after Ctrl+C. Resume is supported only at completed-turn boundaries.
4
- """
5
-
6
- import argparse
7
- import asyncio
8
- import fcntl
9
- import json
10
- import os
11
- from pathlib import Path
12
- import shlex
13
- import uuid
14
-
15
- import httpx
16
-
17
- from rc_echo import EchoWorker, read_login
18
- from rc_penny import read_profile
19
- from rc_restart import RestartWorker
20
- from rc_tools import ToolsWorker
21
- from rc_local import ensure_inactive, phone_history, read_local
22
-
23
-
24
- class ProjectWorker(RestartWorker, ToolsWorker):
25
- def __init__(self, client, oauth, profile, model, directory, project, local=None):
26
- super().__init__(client, oauth, profile, model, directory, project)
27
- self.title = "Penny: " + Path(self.cwd).name
28
- self.phase = "idle"
29
- self.history = []
30
- if self.resuming:
31
- saved = json.loads(self.state_path.read_text())
32
- if saved.get("native_config_dir"):
33
- self.extra_state = {"native_config_dir": saved["native_config_dir"],
34
- "history_synced": saved.get("history_synced", False)}
35
- ensure_inactive(saved["native_config_dir"], self.local_session)
36
- self.claude.persistence_dir = Path(saved["native_config_dir"])
37
- self.claude.resume = True
38
- if not self.extra_state["history_synced"]:
39
- local = read_local(project, self.local_session, saved["native_config_dir"])
40
- if local:
41
- self.local_session = local["session_id"]
42
- self.claude.session_id = self.local_session
43
- self.claude.persistence_dir = Path(local["config_dir"])
44
- self.claude.resume = True
45
- self.extra_state = {"native_config_dir": local["config_dir"], "history_synced": False}
46
- self.history = list(phone_history(local["records"], self.local_session))
47
-
48
- async def start(self):
49
- await super().start()
50
- if self.extra_state and not self.extra_state["history_synced"]:
51
- for offset in range(0, len(self.history), 20):
52
- await self.events(*self.history[offset:offset + 20])
53
- self.extra_state["history_synced"] = True
54
- self.save("idle")
55
- print("Local session: " + self.local_session, flush=True)
56
- print("Return to terminal: penny claude --resume " + self.local_session, flush=True)
57
-
58
- async def handle(self, envelope):
59
- event_id = envelope.get("event_id")
60
- is_new_user = (event_id and event_id not in self.seen and event_id not in self.queued_ids
61
- and envelope.get("payload", {}).get("type") == "user")
62
- if is_new_user:
63
- self.phase = "busy"
64
- self.save(self.phase)
65
- await ToolsWorker.handle(self, envelope)
66
- self.save(self.phase)
67
-
68
- async def process_turns(self):
69
- while not self.stopping:
70
- envelope = await self.inbox.get()
71
- self.active_turn = True
72
- try:
73
- await EchoWorker.handle(self, envelope)
74
- self.queued_ids.discard(envelope["event_id"])
75
- self.phase = "busy" if self.queued_ids else "idle"
76
- self.save(self.phase)
77
- print("Turn saved." if self.phase == "idle" else "Next turn queued.", flush=True)
78
- finally:
79
- self.active_turn = False
80
- self.inbox.task_done()
81
-
82
-
83
- async def run(project, state_dir, effort, local_session=None, continue_local=False):
84
- directory = Path(state_dir).resolve()
85
- directory.mkdir(mode=0o700, parents=True, exist_ok=True)
86
- with (directory / "lock").open("w") as lock:
87
- try:
88
- fcntl.flock(lock, fcntl.LOCK_EX | fcntl.LOCK_NB)
89
- except BlockingIOError:
90
- raise RuntimeError("This remote session is already running.") from None
91
- profile, model = read_profile()
92
- local = None
93
- state_path = directory / "bridge.json"
94
- if local_session or continue_local:
95
- if state_path.exists():
96
- raise RuntimeError("Use a fresh state folder for a local session handoff.")
97
- local = read_local(project, local_session)
98
- model = local["model"] or model
99
- elif state_path.exists():
100
- saved = json.loads(state_path.read_text())
101
- if saved.get("native_config_dir"):
102
- model = saved["model"]
103
- async with httpx.AsyncClient(headers={"anthropic-version": "2023-06-01",
104
- "User-Agent": "penny-rc-project/0.1"}, timeout=httpx.Timeout(30, read=None), trust_env=False) as client:
105
- response = await client.get(profile["gateway_base_url"].rstrip("/") + "/health", timeout=5)
106
- if response.status_code != 200:
107
- raise RuntimeError("Configured Penny gateway is not healthy.")
108
- worker = ProjectWorker(client, read_login(), profile, model, directory, project, local)
109
- worker.claude.effort = effort
110
- tasks = []
111
- try:
112
- await worker.start()
113
- print("PROJECT " + worker.cwd, flush=True)
114
- print("Read/Edit ask on your phone. Stop cancels the current turn. Ctrl+C disconnects.", flush=True)
115
- print("Resume: penny remote --resume " + shlex.quote(str(directory)), flush=True)
116
- tasks = [asyncio.create_task(worker.listen()), asyncio.create_task(worker.heartbeat()),
117
- asyncio.create_task(worker.process_turns())]
118
- done, _ = await asyncio.wait(tasks, return_when=asyncio.FIRST_COMPLETED)
119
- for task in done:
120
- task.result()
121
- finally:
122
- for task in tasks:
123
- task.cancel()
124
- await asyncio.gather(*tasks, return_exceptions=True)
125
- await worker.close()
126
-
127
-
128
- def main():
129
- parser = argparse.ArgumentParser(description=__doc__)
130
- parser.add_argument("project", nargs="?", default=None, help="Project folder (defaults to current directory)")
131
- parser.add_argument("--resume", metavar="STATE_FOLDER", help="Resume a saved Penny remote session")
132
- parser.add_argument("--state-dir", help="State folder for a new session")
133
- local_group = parser.add_mutually_exclusive_group()
134
- local_group.add_argument("--continue", dest="continue_local", action="store_true",
135
- help="Hand off the latest completed local Claude conversation in this project")
136
- local_group.add_argument("--local-session", metavar="UUID", help="Hand off a specific local Claude session")
137
- parser.add_argument("--effort", choices=["low", "medium", "high"], default="low")
138
- args = parser.parse_args()
139
- if args.resume and args.state_dir:
140
- parser.error("Use --resume or --state-dir, not both.")
141
- if args.resume and (args.local_session or args.continue_local):
142
- parser.error("Use --resume for a bridge session, or --continue/--local-session for a local handoff.")
143
- config_root = Path(os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config")))
144
- directory = args.resume or args.state_dir or str(config_root / "pennyrouter/remote" / str(uuid.uuid4()))
145
- project = args.project
146
- if args.resume:
147
- state_path = Path(directory).expanduser() / "bridge.json"
148
- if not state_path.is_file():
149
- parser.error("No saved remote session found in that folder.")
150
- saved = json.loads(state_path.read_text())
151
- project = project or saved["cwd"]
152
- else:
153
- project = project or str(Path.cwd())
154
- if (Path(directory).expanduser() / "bridge.json").exists():
155
- parser.error("State folder already contains a session; use --resume.")
156
- asyncio.run(run(Path(project).expanduser(), Path(directory).expanduser(), args.effort,
157
- args.local_session, args.continue_local))
158
-
159
-
160
- if __name__ == "__main__":
161
- try:
162
- main()
163
- except KeyboardInterrupt:
164
- print("Disconnected. The session remains available to resume.")
165
- except (RuntimeError, TimeoutError, httpx.HTTPError) as error:
166
- print(str(error) if isinstance(error, RuntimeError) else "Remote session stopped after a network or timeout failure.")
167
- raise SystemExit(1)
@@ -1,145 +0,0 @@
1
- """Completed-turn restart probe. State survives exit; credentials are never saved.
2
-
3
- Run with a fresh --state-dir, send one phone message, then rerun the same command.
4
- Tools are disabled. An unfinished turn blocks resume rather than being replayed.
5
- """
6
-
7
- import argparse
8
- import asyncio
9
- import fcntl
10
- import json
11
- import os
12
- from pathlib import Path
13
-
14
- import httpx
15
-
16
- from rc_echo import BASE, read_login
17
- from rc_penny import PennyWorker, read_profile
18
-
19
-
20
- class RestartWorker(PennyWorker):
21
- def __init__(self, client, oauth, profile, model, directory, project=None):
22
- self.directory = Path(directory).resolve()
23
- self.extra_state = {}
24
- self.directory.mkdir(mode=0o700, parents=True, exist_ok=True)
25
- self.state_path = self.directory / "bridge.json"
26
- cwd = Path(project).resolve() if project else self.directory / "workspace"
27
- if project:
28
- if not cwd.is_dir():
29
- raise RuntimeError("Project folder does not exist.")
30
- else:
31
- cwd.mkdir(mode=0o700, exist_ok=True)
32
- super().__init__(client, oauth, profile, model, str(cwd))
33
- self.cwd = str(cwd)
34
- self.title = "Penny restart recovery test"
35
- self.completed = False
36
- self.resuming = self.state_path.exists()
37
- if self.resuming:
38
- state = json.loads(self.state_path.read_text())
39
- if state["phase"] != "idle":
40
- raise RuntimeError("An unfinished turn was recorded. Resume is blocked to avoid replaying it.")
41
- if state["model"] != model:
42
- raise RuntimeError("Resume requires the original model configuration.")
43
- if state.get("cwd", str(cwd)) != str(cwd):
44
- raise RuntimeError("Resume requires the original project folder.")
45
- self.session = state["remote_session"]
46
- self.local_session = state["local_session"]
47
- self.last_event_id = state["cursor"]
48
- self.seen = set(state["seen"])
49
- self.replies = state["replies"]
50
- self.claude.session_id = self.local_session
51
- self.claude.resume = self.replies > 0
52
- self.claude.persistence_dir = self.directory / "claude"
53
- self.claude.persistence_dir.mkdir(mode=0o700, exist_ok=True)
54
-
55
- def save(self, phase):
56
- state = {"version": 1, "phase": phase, "remote_session": self.session,
57
- "local_session": self.local_session, "model": self.model,
58
- "cursor": self.last_event_id, "seen": sorted(self.seen), "replies": self.replies,
59
- "cwd": self.cwd, **self.extra_state}
60
- temporary = self.state_path.with_suffix(".tmp")
61
- descriptor = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
62
- with os.fdopen(descriptor, "w") as handle:
63
- json.dump(state, handle)
64
- handle.flush()
65
- os.fsync(handle.fileno())
66
- os.replace(temporary, self.state_path)
67
-
68
- async def start(self):
69
- if not self.resuming:
70
- await super().start()
71
- else:
72
- bridge = await self.api("POST", self.path + "/bridge", {}, account=True)
73
- if bridge["api_base_url"].rstrip("/") != BASE:
74
- raise RuntimeError("Unexpected worker host; refusing to forward credentials.")
75
- self.worker_token = bridge["worker_jwt"]
76
- self.epoch = int(bridge["worker_epoch"])
77
- await self.status("idle")
78
- print(f"RESUMED https://claude.ai/code/{self.session}", flush=True)
79
- self.save("idle")
80
-
81
- async def handle(self, envelope):
82
- is_turn = envelope.get("payload", {}).get("type") == "user" and envelope.get("event_id") not in self.seen
83
- if is_turn:
84
- self.save("busy")
85
- await super().handle(envelope)
86
- self.save("idle")
87
- if is_turn:
88
- self.completed = True
89
- self.stopping = True
90
- print("Completed turn saved. Restart this command to continue on the same phone link.", flush=True)
91
-
92
- async def close(self):
93
- self.stopping = True
94
- await self.claude.close()
95
- # Preserve the remote session instead of the disposable probes' archive policy.
96
- if self.worker_token:
97
- await self.api("PUT", self.path + "/worker", {
98
- "worker_epoch": self.epoch, "connection_status": "disconnected"})
99
- self.oauth = self.worker_token = ""
100
-
101
-
102
- async def run(directory, seconds):
103
- directory = Path(directory).resolve()
104
- directory.mkdir(mode=0o700, parents=True, exist_ok=True)
105
- with (directory / "lock").open("w") as lock:
106
- try:
107
- fcntl.flock(lock, fcntl.LOCK_EX | fcntl.LOCK_NB)
108
- except BlockingIOError:
109
- raise RuntimeError("Another restart probe is using this state folder.") from None
110
- profile, model = read_profile()
111
- async with httpx.AsyncClient(headers={"anthropic-version": "2023-06-01",
112
- "User-Agent": "penny-rc-restart-probe/0.1"}, timeout=httpx.Timeout(30, read=None), trust_env=False) as client:
113
- response = await client.get(profile["gateway_base_url"].rstrip("/") + "/health", timeout=5)
114
- if response.status_code != 200:
115
- raise RuntimeError("Configured Penny gateway is not healthy.")
116
- worker = RestartWorker(client, read_login(), profile, model, directory)
117
- tasks = []
118
- try:
119
- await worker.start()
120
- tasks = [asyncio.create_task(worker.listen()), asyncio.create_task(worker.heartbeat())]
121
- done, _ = await asyncio.wait(tasks, timeout=seconds, return_when=asyncio.FIRST_COMPLETED)
122
- for task in done:
123
- task.result()
124
- if worker.completed:
125
- # The stream cursor advances after handle() returns.
126
- worker.save("idle")
127
- finally:
128
- for task in tasks:
129
- task.cancel()
130
- await asyncio.gather(*tasks, return_exceptions=True)
131
- await worker.close()
132
-
133
-
134
- if __name__ == "__main__":
135
- parser = argparse.ArgumentParser(description=__doc__)
136
- parser.add_argument("--state-dir", required=True)
137
- parser.add_argument("--seconds", type=int, default=900)
138
- args = parser.parse_args()
139
- try:
140
- asyncio.run(run(args.state_dir, max(1, min(args.seconds, 1800))))
141
- except KeyboardInterrupt:
142
- pass
143
- except (RuntimeError, httpx.HTTPError) as error:
144
- print(str(error) if isinstance(error, RuntimeError) else "Network request failed.")
145
- raise SystemExit(1)
@@ -1,171 +0,0 @@
1
- """Remote file-tool approval probe confined to a disposable test folder.
2
-
3
- Only Read and Edit are available; every call asks the phone. No shell, MCP,
4
- permission-mode changes, or arbitrary control commands are forwarded.
5
- """
6
-
7
- import argparse
8
- import asyncio
9
- import copy
10
- from pathlib import Path
11
- import tempfile
12
-
13
- import httpx
14
-
15
- from rc_echo import EchoWorker, read_login
16
- from rc_penny import PennyClaude, PennyWorker, read_profile
17
-
18
-
19
- def confined_input(cwd, request, tool_input):
20
- if request.get("tool_name") not in {"Read", "Edit"} or not isinstance(tool_input, dict):
21
- return False
22
- path = tool_input.get("file_path")
23
- if not isinstance(path, str) or not path:
24
- return False
25
- root = Path(cwd).resolve()
26
- target = Path(path)
27
- if not target.is_absolute():
28
- target = root / target
29
- try:
30
- return target.resolve().is_relative_to(root) and target.resolve() != root
31
- except (OSError, ValueError):
32
- return False
33
-
34
-
35
- class ToolsWorker(PennyWorker):
36
- def __init__(self, client, oauth, profile, model, cwd):
37
- super().__init__(client, oauth, profile, model, cwd)
38
- self.title = "Penny file approvals test"
39
- self.cwd = cwd
40
- self.tools = ["Read", "Edit"]
41
- self.claude = PennyClaude(profile, model, self.local_session, cwd, self.permission)
42
- self.pending_permissions = {}
43
- self.permission_futures = {}
44
- self.inbox = asyncio.Queue(maxsize=10)
45
- self.queued_ids = set()
46
- self.active_turn = False
47
- self.disconnect_after_turns = 0
48
-
49
- async def permission(self, event):
50
- request = event.get("request", {})
51
- denied = {"behavior": "deny", "message": "Only file operations inside this test folder are permitted."}
52
- if request.get("subtype") != "can_use_tool" or not confined_input(self.cwd, request, request.get("input")):
53
- return denied
54
- request_id = event["request_id"]
55
- future = asyncio.get_running_loop().create_future()
56
- saved = copy.deepcopy(event)
57
- self.pending_permissions[request_id] = saved
58
- self.permission_futures[request_id] = future
59
- print(f"Phone approval needed: {request['tool_name']}", flush=True)
60
- try:
61
- await self.events({**saved, "session_id": self.local_session, "uuid": self.payload("unused")["uuid"]})
62
- async with asyncio.timeout(180):
63
- decision = await future
64
- if decision.get("behavior") == "allow":
65
- tool_input = decision.get("updatedInput", request["input"])
66
- if not confined_input(self.cwd, request, tool_input):
67
- return denied
68
- # Accept one tool decision, never persistent permission updates.
69
- return {"behavior": "allow", "updatedInput": tool_input}
70
- return {"behavior": "deny", "message": "The user denied this tool from the phone."}
71
- except TimeoutError:
72
- return {"behavior": "deny", "message": "Phone approval timed out."}
73
- finally:
74
- self.pending_permissions.pop(request_id, None)
75
- self.permission_futures.pop(request_id, None)
76
-
77
- async def handle(self, envelope):
78
- event_id = envelope.get("event_id")
79
- if not event_id or event_id in self.seen or event_id in self.queued_ids:
80
- return
81
- payload = envelope.get("payload", {})
82
- kind = payload.get("type")
83
- if kind == "user":
84
- self.queued_ids.add(event_id)
85
- await self.inbox.put(envelope)
86
- return
87
- if kind == "control_response":
88
- await self.delivery(event_id, "received")
89
- response = payload.get("response", {})
90
- request_id = response.get("request_id")
91
- future = self.permission_futures.get(request_id)
92
- if future is not None and not future.done():
93
- decision = response.get("response", {}) if response.get("subtype") == "success" else {}
94
- future.set_result(decision)
95
- print(f"Phone decision: {decision.get('behavior', 'deny')}", flush=True)
96
- else:
97
- print("Ignored unmatched permission response", flush=True)
98
- await self.delivery(event_id, "processed")
99
- self.seen.add(event_id)
100
- return
101
- if kind == "control_request" and payload.get("request", {}).get("subtype") == "interrupt":
102
- await self.delivery(event_id, "received")
103
- for future in self.permission_futures.values():
104
- if not future.done():
105
- future.set_result({"behavior": "deny"})
106
- if self.active_turn:
107
- await self.claude.interrupt(payload["request_id"])
108
- else:
109
- await self.events(self.payload("control_response", response={
110
- "subtype": "success", "request_id": payload.get("request_id"), "response": {}}))
111
- await self.delivery(event_id, "processed")
112
- self.seen.add(event_id)
113
- return
114
- await EchoWorker.handle(self, envelope)
115
-
116
- async def process_turns(self):
117
- while not self.stopping:
118
- envelope = await self.inbox.get()
119
- self.active_turn = True
120
- try:
121
- await EchoWorker.handle(self, envelope)
122
- if self.disconnect_after_turns and self.replies == self.disconnect_after_turns:
123
- self.force_reconnect.set()
124
- finally:
125
- self.active_turn = False
126
- self.queued_ids.discard(envelope["event_id"])
127
- self.inbox.task_done()
128
-
129
-
130
- async def run(seconds, effort="low", disconnect_after_turns=0):
131
- profile, model = read_profile()
132
- async with httpx.AsyncClient(headers={"anthropic-version": "2023-06-01",
133
- "User-Agent": "penny-rc-file-probe/0.1"}, timeout=httpx.Timeout(30, read=None), trust_env=False) as client:
134
- response = await client.get(profile["gateway_base_url"].rstrip("/") + "/health", timeout=5)
135
- if response.status_code != 200:
136
- raise RuntimeError("Configured Penny gateway is not healthy.")
137
- with tempfile.TemporaryDirectory(prefix="penny-rc-files-") as cwd:
138
- (Path(cwd) / "note.txt").write_text("original test content\n")
139
- worker = ToolsWorker(client, read_login(), profile, model, cwd)
140
- worker.claude.effort = effort
141
- worker.disconnect_after_turns = disconnect_after_turns
142
- tasks = []
143
- try:
144
- await worker.start()
145
- print("TEST FOLDER " + cwd, flush=True)
146
- tasks = [asyncio.create_task(worker.listen()), asyncio.create_task(worker.heartbeat()),
147
- asyncio.create_task(worker.process_turns())]
148
- done, _ = await asyncio.wait(tasks, timeout=seconds, return_when=asyncio.FIRST_COMPLETED)
149
- for task in done:
150
- task.result()
151
- finally:
152
- for task in tasks:
153
- task.cancel()
154
- await asyncio.gather(*tasks, return_exceptions=True)
155
- await worker.close()
156
-
157
-
158
- if __name__ == "__main__":
159
- parser = argparse.ArgumentParser(description=__doc__)
160
- parser.add_argument("--seconds", type=int, default=900)
161
- parser.add_argument("--effort", choices=["low", "medium", "high"], default="low")
162
- parser.add_argument("--disconnect-after-turns", type=int, default=0,
163
- help="Simulate one three-second stream drop after this many completed turns")
164
- args = parser.parse_args()
165
- try:
166
- asyncio.run(run(max(1, min(args.seconds, 1800)), args.effort, args.disconnect_after_turns))
167
- except KeyboardInterrupt:
168
- pass
169
- except (RuntimeError, TimeoutError, httpx.HTTPError):
170
- print("File approval probe stopped after a protocol, gateway, or timeout failure.")
171
- raise SystemExit(1)