pi-harness-runtime 1.1.335 → 1.1.337
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.
- package/index.ts +21 -12
- package/package.json +1 -1
- package/packages/a2a-adapter/package.json +1 -1
- package/packages/agent-policy/package.json +1 -1
- package/packages/architecture-generator/package.json +1 -1
- package/packages/auth/package.json +1 -1
- package/packages/autonomous-refactor/package.json +1 -1
- package/packages/autonomous-runtime/package.json +1 -1
- package/packages/cache-strategy/package.json +1 -1
- package/packages/capability-registry/package.json +1 -1
- package/packages/checkpoint/package.json +1 -1
- package/packages/cli-plugin-sdk/package.json +1 -1
- package/packages/clipboard/package.json +1 -1
- package/packages/clipboard-plugin/package.json +1 -1
- package/packages/code-generation/package.json +1 -1
- package/packages/code-review/package.json +1 -1
- package/packages/codex-adapter/package.json +1 -1
- package/packages/codex-watcher/package.json +1 -1
- package/packages/config-capture/package.json +1 -1
- package/packages/connection-runtime/dist/index.d.ts +11 -0
- package/packages/connection-runtime/dist/index.js +11 -0
- package/packages/connection-runtime/dist/registry.d.ts +69 -0
- package/packages/connection-runtime/dist/registry.js +117 -0
- package/packages/connection-runtime/dist/supervisor.d.ts +89 -0
- package/packages/connection-runtime/dist/supervisor.js +169 -0
- package/packages/connection-runtime/dist/types.d.ts +70 -0
- package/packages/connection-runtime/dist/types.js +16 -0
- package/packages/connection-runtime/package.json +24 -0
- package/packages/connection-runtime/src/index.ts +12 -0
- package/packages/connection-runtime/src/registry.ts +142 -0
- package/packages/connection-runtime/src/supervisor.ts +224 -0
- package/packages/connection-runtime/src/types.ts +88 -0
- package/packages/context-compiler/package.json +1 -1
- package/packages/context-discovery/package.json +1 -1
- package/packages/context-manager/package.json +1 -1
- package/packages/contracts/dist/approvals.d.ts +273 -0
- package/packages/contracts/dist/approvals.js +93 -0
- package/packages/contracts/dist/base.d.ts +78 -0
- package/packages/contracts/dist/base.js +82 -0
- package/packages/contracts/dist/events.d.ts +99 -0
- package/packages/contracts/dist/events.js +65 -0
- package/packages/contracts/dist/index.d.ts +20 -0
- package/packages/contracts/dist/index.js +20 -0
- package/packages/contracts/dist/jobs.d.ts +234 -0
- package/packages/contracts/dist/jobs.js +79 -0
- package/packages/contracts/dist/notifications.d.ts +317 -0
- package/packages/contracts/dist/notifications.js +85 -0
- package/packages/contracts/dist/projects.d.ts +171 -0
- package/packages/contracts/dist/projects.js +62 -0
- package/packages/contracts/dist/sessions.d.ts +226 -0
- package/packages/contracts/dist/sessions.js +82 -0
- package/packages/contracts/package.json +24 -0
- package/packages/contracts/src/approvals.ts +115 -0
- package/packages/contracts/src/base.ts +126 -0
- package/packages/contracts/src/events.ts +78 -0
- package/packages/contracts/src/index.ts +21 -0
- package/packages/contracts/src/jobs.ts +101 -0
- package/packages/contracts/src/notifications.ts +104 -0
- package/packages/contracts/src/projects.ts +81 -0
- package/packages/contracts/src/sessions.ts +104 -0
- package/packages/cookie-sanitizer/package.json +1 -1
- package/packages/cost-optimizer/package.json +1 -1
- package/packages/dependency-analyzer/package.json +1 -1
- package/packages/django-plugin/package.json +1 -1
- package/packages/doc-generator/package.json +1 -1
- package/packages/durable-review/package.json +1 -1
- package/packages/e2e-tester/package.json +1 -1
- package/packages/evaluation-engine/package.json +1 -1
- package/packages/evaluation-runner/package.json +1 -1
- package/packages/event-bus/package.json +1 -1
- package/packages/event-sink/dist/index.d.ts +12 -0
- package/packages/event-sink/dist/index.js +12 -0
- package/packages/event-sink/dist/outbox.d.ts +51 -0
- package/packages/event-sink/dist/outbox.js +88 -0
- package/packages/event-sink/dist/projection.d.ts +41 -0
- package/packages/event-sink/dist/projection.js +62 -0
- package/packages/event-sink/dist/sink.d.ts +81 -0
- package/packages/event-sink/dist/sink.js +106 -0
- package/packages/event-sink/package.json +28 -0
- package/packages/event-sink/src/index.ts +15 -0
- package/packages/event-sink/src/outbox.ts +119 -0
- package/packages/event-sink/src/projection.ts +84 -0
- package/packages/event-sink/src/sink.ts +167 -0
- package/packages/event-store/package.json +1 -1
- package/packages/experience-replay/package.json +1 -1
- package/packages/feedback-collector/package.json +1 -1
- package/packages/file-copy-helper/package.json +1 -1
- package/packages/framework-detector/package.json +1 -1
- package/packages/framework-plugin-sdk/package.json +1 -1
- package/packages/frappe-plugin/package.json +1 -1
- package/packages/generic-web-plugin/package.json +1 -1
- package/packages/health-monitor/package.json +1 -1
- package/packages/intent-analyzer/package.json +1 -1
- package/packages/jev-judge/package.json +1 -1
- package/packages/knowledge-graph/package.json +1 -1
- package/packages/knowledge-retrieval/package.json +1 -1
- package/packages/laravel-plugin/package.json +1 -1
- package/packages/learning-engine/package.json +1 -1
- package/packages/mcp-adapter/package.json +1 -1
- package/packages/memory-engine/package.json +1 -1
- package/packages/milestone-manager/package.json +1 -1
- package/packages/model-registry/package.json +1 -1
- package/packages/nextjs-plugin/package.json +1 -1
- package/packages/notification/package.json +1 -1
- package/packages/observability/package.json +1 -1
- package/packages/okf-indexer/package.json +1 -1
- package/packages/paperclip-integration/package.json +1 -1
- package/packages/performance-optimizer/package.json +1 -1
- package/packages/permission-mode/dist/checker.d.ts +66 -0
- package/packages/permission-mode/dist/checker.js +64 -0
- package/packages/permission-mode/dist/index.d.ts +12 -0
- package/packages/permission-mode/dist/index.js +11 -0
- package/packages/permission-mode/dist/manager.d.ts +65 -0
- package/packages/permission-mode/dist/manager.js +91 -0
- package/packages/permission-mode/dist/mode.d.ts +31 -0
- package/packages/permission-mode/dist/mode.js +47 -0
- package/packages/permission-mode/package.json +24 -0
- package/packages/permission-mode/src/checker.ts +103 -0
- package/packages/permission-mode/src/index.ts +13 -0
- package/packages/permission-mode/src/manager.ts +154 -0
- package/packages/permission-mode/src/mode.ts +73 -0
- package/packages/privilege-broker/package.json +1 -1
- package/packages/project-analyzer/package.json +1 -1
- package/packages/project-bootstrap/package.json +1 -1
- package/packages/projection-engine/package.json +1 -1
- package/packages/prompt-compiler/package.json +1 -1
- package/packages/prompt-versioning/package.json +1 -1
- package/packages/provider-adapter-sdk/package.json +1 -1
- package/packages/provider-router/package.json +1 -1
- package/packages/provider-selector/package.json +1 -1
- package/packages/providers/package.json +1 -1
- package/packages/qdrant-skills/package.json +1 -1
- package/packages/quota-manager/package.json +1 -1
- package/packages/rate-limiter/package.json +1 -1
- package/packages/react-vite-plugin/package.json +1 -1
- package/packages/relay/dist/client.d.ts +53 -0
- package/packages/relay/dist/client.js +95 -0
- package/packages/relay/dist/index.d.ts +9 -0
- package/packages/relay/dist/index.js +8 -0
- package/packages/relay/dist/server.d.ts +58 -0
- package/packages/relay/dist/server.js +93 -0
- package/packages/relay/dist/types.d.ts +35 -0
- package/packages/relay/dist/types.js +4 -0
- package/packages/relay/package.json +24 -0
- package/packages/relay/src/client.ts +119 -0
- package/packages/relay/src/index.ts +10 -0
- package/packages/relay/src/server.ts +120 -0
- package/packages/relay/src/types.ts +38 -0
- package/packages/release-manager/package.json +1 -1
- package/packages/requirement-compiler/package.json +1 -1
- package/packages/runtime/package.json +1 -1
- package/packages/scheduler/package.json +1 -1
- package/packages/scheduler-adapter/package.json +1 -1
- package/packages/session/package.json +1 -1
- package/packages/session-api/package.json +1 -1
- package/packages/session-export/package.json +1 -1
- package/packages/shared-context/package.json +1 -1
- package/packages/skill-mcp-client/package.json +1 -1
- package/packages/skill-registry/package.json +1 -1
- package/packages/skills/package.json +1 -1
- package/packages/sprint-planner/package.json +1 -1
- package/packages/subscription-engine/package.json +1 -1
- package/packages/task-compiler/package.json +1 -1
- package/packages/telegram/package.json +1 -1
- package/packages/tencentdb-memory/package.json +1 -1
- package/packages/tencentdb-sync/package.json +1 -1
- package/packages/test-data-generator/package.json +1 -1
- package/packages/test-generator/package.json +1 -1
- package/packages/todo-bd-sync/package.json +1 -1
- package/packages/token-estimation/package.json +1 -1
- package/packages/token-optimizer/package.json +1 -1
- package/packages/trajectory/package.json +1 -1
- package/packages/tui/package.json +1 -1
- package/packages/types/package.json +1 -1
- package/packages/webmcp-tester/package.json +1 -1
- package/packages/wiki/package.json +1 -1
- package/packages/workflow-events/package.json +1 -1
- package/packages/workspace-scanner/package.json +1 -1
- package/packages/worktree/package.json +1 -1
- package/packages/write-review/package.json +1 -1
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Server - Cloud relay server for tunnels
|
|
3
|
+
*/
|
|
4
|
+
import type { RelayTunnel, RelayMessage } from './types.js';
|
|
5
|
+
/**
|
|
6
|
+
* Relay Server options
|
|
7
|
+
*/
|
|
8
|
+
export interface RelayServerOptions {
|
|
9
|
+
/** Port to listen on */
|
|
10
|
+
port?: number;
|
|
11
|
+
/** Host to bind */
|
|
12
|
+
host?: string;
|
|
13
|
+
/** Called when a tunnel connects */
|
|
14
|
+
onTunnelConnect?: (tunnel: RelayTunnel) => void;
|
|
15
|
+
/** Called when a tunnel disconnects */
|
|
16
|
+
onTunnelDisconnect?: (tunnelId: string) => void;
|
|
17
|
+
/** Called when a message is received */
|
|
18
|
+
onMessage?: (tunnelId: string, message: RelayMessage) => void;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Relay Server
|
|
22
|
+
*
|
|
23
|
+
* Manages tunnels and relays messages between clients.
|
|
24
|
+
*/
|
|
25
|
+
export declare class RelayServer {
|
|
26
|
+
private tunnels;
|
|
27
|
+
private options;
|
|
28
|
+
private running;
|
|
29
|
+
constructor(options?: RelayServerOptions);
|
|
30
|
+
/**
|
|
31
|
+
* Start the relay server
|
|
32
|
+
*/
|
|
33
|
+
start(): Promise<void>;
|
|
34
|
+
/**
|
|
35
|
+
* Stop the relay server
|
|
36
|
+
*/
|
|
37
|
+
stop(): Promise<void>;
|
|
38
|
+
/**
|
|
39
|
+
* Get all active tunnels
|
|
40
|
+
*/
|
|
41
|
+
getTunnels(): RelayTunnel[];
|
|
42
|
+
/**
|
|
43
|
+
* Get tunnel by ID
|
|
44
|
+
*/
|
|
45
|
+
getTunnel(id: string): RelayTunnel | undefined;
|
|
46
|
+
/**
|
|
47
|
+
* Create a tunnel
|
|
48
|
+
*/
|
|
49
|
+
createTunnel(localPort: number): RelayTunnel;
|
|
50
|
+
/**
|
|
51
|
+
* Remove a tunnel
|
|
52
|
+
*/
|
|
53
|
+
removeTunnel(id: string): boolean;
|
|
54
|
+
/**
|
|
55
|
+
* Check if server is running
|
|
56
|
+
*/
|
|
57
|
+
isRunning(): boolean;
|
|
58
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Server - Cloud relay server for tunnels
|
|
3
|
+
*/
|
|
4
|
+
/**
|
|
5
|
+
* Generate a UUID v4
|
|
6
|
+
*/
|
|
7
|
+
function generateUUID() {
|
|
8
|
+
// Use crypto.randomUUID if available
|
|
9
|
+
const crypto = globalThis;
|
|
10
|
+
if (crypto.crypto?.randomUUID) {
|
|
11
|
+
return crypto.crypto.randomUUID();
|
|
12
|
+
}
|
|
13
|
+
// Fallback
|
|
14
|
+
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
|
|
15
|
+
const r = (Math.random() * 16) | 0;
|
|
16
|
+
const v = c === 'x' ? r : (r & 0x3) | 0x8;
|
|
17
|
+
return v.toString(16);
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Relay Server
|
|
22
|
+
*
|
|
23
|
+
* Manages tunnels and relays messages between clients.
|
|
24
|
+
*/
|
|
25
|
+
export class RelayServer {
|
|
26
|
+
tunnels = new Map();
|
|
27
|
+
options;
|
|
28
|
+
running = false;
|
|
29
|
+
constructor(options = {}) {
|
|
30
|
+
this.options = {
|
|
31
|
+
port: options.port ?? 3001,
|
|
32
|
+
host: options.host ?? '0.0.0.0',
|
|
33
|
+
onTunnelConnect: options.onTunnelConnect ?? (() => { }),
|
|
34
|
+
onTunnelDisconnect: options.onTunnelDisconnect ?? (() => { }),
|
|
35
|
+
onMessage: options.onMessage ?? (() => { }),
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Start the relay server
|
|
40
|
+
*/
|
|
41
|
+
async start() {
|
|
42
|
+
if (this.running)
|
|
43
|
+
return;
|
|
44
|
+
this.running = true;
|
|
45
|
+
// Note: Actual HTTP/WebSocket server would be implemented here
|
|
46
|
+
// For now, this is a stub that can be expanded with actual server code
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Stop the relay server
|
|
50
|
+
*/
|
|
51
|
+
async stop() {
|
|
52
|
+
this.running = false;
|
|
53
|
+
this.tunnels.clear();
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Get all active tunnels
|
|
57
|
+
*/
|
|
58
|
+
getTunnels() {
|
|
59
|
+
return Array.from(this.tunnels.values());
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Get tunnel by ID
|
|
63
|
+
*/
|
|
64
|
+
getTunnel(id) {
|
|
65
|
+
return this.tunnels.get(id);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Create a tunnel
|
|
69
|
+
*/
|
|
70
|
+
createTunnel(localPort) {
|
|
71
|
+
const tunnel = {
|
|
72
|
+
id: generateUUID(),
|
|
73
|
+
url: `https://tunnel-${Date.now()}.relay.example.com`,
|
|
74
|
+
localPort,
|
|
75
|
+
status: 'connecting',
|
|
76
|
+
createdAt: new Date().toISOString(),
|
|
77
|
+
};
|
|
78
|
+
this.tunnels.set(tunnel.id, tunnel);
|
|
79
|
+
return tunnel;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Remove a tunnel
|
|
83
|
+
*/
|
|
84
|
+
removeTunnel(id) {
|
|
85
|
+
return this.tunnels.delete(id);
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Check if server is running
|
|
89
|
+
*/
|
|
90
|
+
isRunning() {
|
|
91
|
+
return this.running;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Types
|
|
3
|
+
*/
|
|
4
|
+
export interface RelayConfig {
|
|
5
|
+
/** Relay server URL */
|
|
6
|
+
serverUrl: string;
|
|
7
|
+
/** Authentication token */
|
|
8
|
+
token?: string;
|
|
9
|
+
/** Environment ID */
|
|
10
|
+
environmentId?: string;
|
|
11
|
+
/** Keep alive interval in ms */
|
|
12
|
+
keepAlive?: number;
|
|
13
|
+
/** Connect timeout in ms */
|
|
14
|
+
connectTimeout?: number;
|
|
15
|
+
}
|
|
16
|
+
export interface RelayTunnel {
|
|
17
|
+
/** Tunnel ID */
|
|
18
|
+
id: string;
|
|
19
|
+
/** Public URL for the tunnel */
|
|
20
|
+
url: string;
|
|
21
|
+
/** Local port being tunneled */
|
|
22
|
+
localPort: number;
|
|
23
|
+
/** Connection status */
|
|
24
|
+
status: 'connecting' | 'connected' | 'disconnected' | 'error';
|
|
25
|
+
/** Created timestamp */
|
|
26
|
+
createdAt: string;
|
|
27
|
+
/** Error message if any */
|
|
28
|
+
error?: string;
|
|
29
|
+
}
|
|
30
|
+
export interface RelayMessage {
|
|
31
|
+
type: 'connect' | 'disconnect' | 'data' | 'ping' | 'pong' | 'error';
|
|
32
|
+
tunnelId?: string;
|
|
33
|
+
payload?: unknown;
|
|
34
|
+
timestamp: string;
|
|
35
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@pi-harness/relay",
|
|
3
|
+
"version": "1.1.337",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Cloud relay for remote access - T3 Connect style for pi-harness",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"import": "./dist/index.js",
|
|
11
|
+
"types": "./dist/index.d.ts"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"scripts": {
|
|
15
|
+
"build": "tsc",
|
|
16
|
+
"test": "bun test"
|
|
17
|
+
},
|
|
18
|
+
"dependencies": {
|
|
19
|
+
"@pi-harness/contracts": "workspace:*"
|
|
20
|
+
},
|
|
21
|
+
"devDependencies": {
|
|
22
|
+
"typescript": "^5.7.2"
|
|
23
|
+
}
|
|
24
|
+
}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Client - Connect to relay server for remote access
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import type { RelayConfig, RelayTunnel, RelayMessage } from './types.js';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Generate a UUID v4
|
|
9
|
+
*/
|
|
10
|
+
function generateUUID(): string {
|
|
11
|
+
// Use crypto.randomUUID if available (Node.js 14.17+)
|
|
12
|
+
const crypto = globalThis as { crypto?: { randomUUID?: () => string } };
|
|
13
|
+
if (crypto.crypto?.randomUUID) {
|
|
14
|
+
return crypto.crypto.randomUUID();
|
|
15
|
+
}
|
|
16
|
+
// Fallback: simple UUID generation
|
|
17
|
+
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c: string) => {
|
|
18
|
+
const r = (Math.random() * 16) | 0;
|
|
19
|
+
const v = c === 'x' ? r : (r & 0x3) | 0x8;
|
|
20
|
+
return v.toString(16);
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Relay Client options
|
|
26
|
+
*/
|
|
27
|
+
export interface RelayClientOptions {
|
|
28
|
+
/** Called when connected */
|
|
29
|
+
onConnected?: () => void;
|
|
30
|
+
/** Called when disconnected */
|
|
31
|
+
onDisconnected?: () => void;
|
|
32
|
+
/** Called when tunnel is established */
|
|
33
|
+
onTunnel?: (tunnel: RelayTunnel) => void;
|
|
34
|
+
/** Called on error */
|
|
35
|
+
onError?: (error: Error) => void;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Relay Client
|
|
40
|
+
*
|
|
41
|
+
* Connects to a relay server and establishes tunnels for remote access.
|
|
42
|
+
*/
|
|
43
|
+
export class RelayClient {
|
|
44
|
+
private config: RelayConfig;
|
|
45
|
+
private options: RelayClientOptions;
|
|
46
|
+
private connected = false;
|
|
47
|
+
private tunnel?: RelayTunnel;
|
|
48
|
+
|
|
49
|
+
constructor(config: RelayConfig, options: RelayClientOptions) {
|
|
50
|
+
this.config = config;
|
|
51
|
+
this.options = options;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Connect to relay server
|
|
56
|
+
*/
|
|
57
|
+
async connect(): Promise<void> {
|
|
58
|
+
if (this.connected) return;
|
|
59
|
+
|
|
60
|
+
try {
|
|
61
|
+
// In a real implementation, this would establish WebSocket connection
|
|
62
|
+
// to the relay server and authenticate
|
|
63
|
+
this.connected = true;
|
|
64
|
+
this.options.onConnected?.();
|
|
65
|
+
} catch (error) {
|
|
66
|
+
this.options.onError?.(error as Error);
|
|
67
|
+
throw error;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Disconnect from relay server
|
|
73
|
+
*/
|
|
74
|
+
async disconnect(): Promise<void> {
|
|
75
|
+
this.connected = false;
|
|
76
|
+
this.tunnel = undefined;
|
|
77
|
+
this.options.onDisconnected?.();
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Create a tunnel
|
|
82
|
+
*/
|
|
83
|
+
async createTunnel(localPort: number): Promise<RelayTunnel> {
|
|
84
|
+
const tunnel: RelayTunnel = {
|
|
85
|
+
id: generateUUID(),
|
|
86
|
+
url: `${this.config.serverUrl}/tunnel/${localPort}`,
|
|
87
|
+
localPort,
|
|
88
|
+
status: this.connected ? 'connected' : 'disconnected',
|
|
89
|
+
createdAt: new Date().toISOString(),
|
|
90
|
+
};
|
|
91
|
+
this.tunnel = tunnel;
|
|
92
|
+
this.options.onTunnel?.(tunnel);
|
|
93
|
+
return tunnel;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Send a message through the tunnel
|
|
98
|
+
*/
|
|
99
|
+
async send(_message: RelayMessage): Promise<void> {
|
|
100
|
+
if (!this.connected) {
|
|
101
|
+
throw new Error('Not connected to relay server');
|
|
102
|
+
}
|
|
103
|
+
// In a real implementation, this would send the message over WebSocket
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Check if connected
|
|
108
|
+
*/
|
|
109
|
+
isConnected(): boolean {
|
|
110
|
+
return this.connected;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Get current tunnel
|
|
115
|
+
*/
|
|
116
|
+
getTunnel(): RelayTunnel | undefined {
|
|
117
|
+
return this.tunnel;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cloud Relay - T3 Connect Style
|
|
3
|
+
*
|
|
4
|
+
* Enables remote access to pi-harness without router/port forwarding.
|
|
5
|
+
* Based on T3Code's T3 Connect architecture.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
export { RelayServer } from './server.js';
|
|
9
|
+
export { RelayClient } from './client.js';
|
|
10
|
+
export { RelayConfig, RelayTunnel } from './types.js';
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Server - Cloud relay server for tunnels
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import type { RelayConfig, RelayTunnel, RelayMessage } from './types.js';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Generate a UUID v4
|
|
9
|
+
*/
|
|
10
|
+
function generateUUID(): string {
|
|
11
|
+
// Use crypto.randomUUID if available
|
|
12
|
+
const crypto = globalThis as { crypto?: { randomUUID?: () => string } };
|
|
13
|
+
if (crypto.crypto?.randomUUID) {
|
|
14
|
+
return crypto.crypto.randomUUID();
|
|
15
|
+
}
|
|
16
|
+
// Fallback
|
|
17
|
+
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c: string) => {
|
|
18
|
+
const r = (Math.random() * 16) | 0;
|
|
19
|
+
const v = c === 'x' ? r : (r & 0x3) | 0x8;
|
|
20
|
+
return v.toString(16);
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Relay Server options
|
|
26
|
+
*/
|
|
27
|
+
export interface RelayServerOptions {
|
|
28
|
+
/** Port to listen on */
|
|
29
|
+
port?: number;
|
|
30
|
+
/** Host to bind */
|
|
31
|
+
host?: string;
|
|
32
|
+
/** Called when a tunnel connects */
|
|
33
|
+
onTunnelConnect?: (tunnel: RelayTunnel) => void;
|
|
34
|
+
/** Called when a tunnel disconnects */
|
|
35
|
+
onTunnelDisconnect?: (tunnelId: string) => void;
|
|
36
|
+
/** Called when a message is received */
|
|
37
|
+
onMessage?: (tunnelId: string, message: RelayMessage) => void;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Relay Server
|
|
42
|
+
*
|
|
43
|
+
* Manages tunnels and relays messages between clients.
|
|
44
|
+
*/
|
|
45
|
+
export class RelayServer {
|
|
46
|
+
private tunnels = new Map<string, RelayTunnel>();
|
|
47
|
+
private options: Required<RelayServerOptions>;
|
|
48
|
+
private running = false;
|
|
49
|
+
|
|
50
|
+
constructor(options: RelayServerOptions = {}) {
|
|
51
|
+
this.options = {
|
|
52
|
+
port: options.port ?? 3001,
|
|
53
|
+
host: options.host ?? '0.0.0.0',
|
|
54
|
+
onTunnelConnect: options.onTunnelConnect ?? (() => {}),
|
|
55
|
+
onTunnelDisconnect: options.onTunnelDisconnect ?? (() => {}),
|
|
56
|
+
onMessage: options.onMessage ?? (() => {}),
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Start the relay server
|
|
62
|
+
*/
|
|
63
|
+
async start(): Promise<void> {
|
|
64
|
+
if (this.running) return;
|
|
65
|
+
this.running = true;
|
|
66
|
+
// Note: Actual HTTP/WebSocket server would be implemented here
|
|
67
|
+
// For now, this is a stub that can be expanded with actual server code
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Stop the relay server
|
|
72
|
+
*/
|
|
73
|
+
async stop(): Promise<void> {
|
|
74
|
+
this.running = false;
|
|
75
|
+
this.tunnels.clear();
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Get all active tunnels
|
|
80
|
+
*/
|
|
81
|
+
getTunnels(): RelayTunnel[] {
|
|
82
|
+
return Array.from(this.tunnels.values());
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Get tunnel by ID
|
|
87
|
+
*/
|
|
88
|
+
getTunnel(id: string): RelayTunnel | undefined {
|
|
89
|
+
return this.tunnels.get(id);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Create a tunnel
|
|
94
|
+
*/
|
|
95
|
+
createTunnel(localPort: number): RelayTunnel {
|
|
96
|
+
const tunnel: RelayTunnel = {
|
|
97
|
+
id: generateUUID(),
|
|
98
|
+
url: `https://tunnel-${Date.now()}.relay.example.com`,
|
|
99
|
+
localPort,
|
|
100
|
+
status: 'connecting',
|
|
101
|
+
createdAt: new Date().toISOString(),
|
|
102
|
+
};
|
|
103
|
+
this.tunnels.set(tunnel.id, tunnel);
|
|
104
|
+
return tunnel;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Remove a tunnel
|
|
109
|
+
*/
|
|
110
|
+
removeTunnel(id: string): boolean {
|
|
111
|
+
return this.tunnels.delete(id);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Check if server is running
|
|
116
|
+
*/
|
|
117
|
+
isRunning(): boolean {
|
|
118
|
+
return this.running;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Relay Types
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
export interface RelayConfig {
|
|
6
|
+
/** Relay server URL */
|
|
7
|
+
serverUrl: string;
|
|
8
|
+
/** Authentication token */
|
|
9
|
+
token?: string;
|
|
10
|
+
/** Environment ID */
|
|
11
|
+
environmentId?: string;
|
|
12
|
+
/** Keep alive interval in ms */
|
|
13
|
+
keepAlive?: number;
|
|
14
|
+
/** Connect timeout in ms */
|
|
15
|
+
connectTimeout?: number;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export interface RelayTunnel {
|
|
19
|
+
/** Tunnel ID */
|
|
20
|
+
id: string;
|
|
21
|
+
/** Public URL for the tunnel */
|
|
22
|
+
url: string;
|
|
23
|
+
/** Local port being tunneled */
|
|
24
|
+
localPort: number;
|
|
25
|
+
/** Connection status */
|
|
26
|
+
status: 'connecting' | 'connected' | 'disconnected' | 'error';
|
|
27
|
+
/** Created timestamp */
|
|
28
|
+
createdAt: string;
|
|
29
|
+
/** Error message if any */
|
|
30
|
+
error?: string;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export interface RelayMessage {
|
|
34
|
+
type: 'connect' | 'disconnect' | 'data' | 'ping' | 'pong' | 'error';
|
|
35
|
+
tunnelId?: string;
|
|
36
|
+
payload?: unknown;
|
|
37
|
+
timestamp: string;
|
|
38
|
+
}
|