4d4b03be96
- Define Computer interface with Exec, Stream, VNC, Proxy, ComputerInfo, BindWorkplace, and Workplace methods in types.go - Implement Computer interface on Host (VNC and Proxy via Tai gRPC) - Add VNC/Proxy stubs to Box (delegates to Tai HTTP endpoints) - Update JSAPI bindings for unified computer.vnc() and computer.proxy() - Extend host_test.go with __host__ VNC and HTTP proxy test cases Made-with: Cursor
134 lines
4.7 KiB
Go
134 lines
4.7 KiB
Go
package jsapi
|
|
|
|
import (
|
|
"rogchap.com/v8go"
|
|
)
|
|
|
|
// NewBoxObject creates a JS Box object backed by a sandbox ID string.
|
|
// All methods delegate to the Go sandbox.M() singleton — no Go object is
|
|
// passed to V8, no bridge registration, no Release() needed.
|
|
//
|
|
// Box implements the Computer interface, so it shares the unified Exec/Stream/
|
|
// VNC/Proxy/ComputerInfo/BindWorkplace/Workplace methods with Host. It also
|
|
// has Box-specific methods (Attach, Info, Start, Stop, Remove).
|
|
//
|
|
// # Properties (read-only)
|
|
//
|
|
// box.id → string // sandbox ID ← Box.ID()
|
|
// box.owner → string // owner user ID ← Box.Owner()
|
|
// box.pool → string // pool name ← Box.Pool()
|
|
//
|
|
// # Methods — Computer interface (unified with Host)
|
|
//
|
|
// box.Exec(cmd, options?) → ExecResult
|
|
//
|
|
// Go: Computer.Exec(ctx, cmd []string, opts ...ExecOption) (*ExecResult, error)
|
|
//
|
|
// JS args:
|
|
// cmd: string[] → cmd []string
|
|
// options: { → ExecOption
|
|
// workdir: string, → WithWorkDir(dir)
|
|
// env: object, → WithEnv(map[string]string)
|
|
// stdin: string, → WithStdin([]byte)
|
|
// timeout: number, → WithTimeout(ms → time.Duration)
|
|
// max_output: number → WithMaxOutput(bytes int64)
|
|
// }
|
|
// JS returns: {
|
|
// exit_code: number, ← ExecResult.ExitCode
|
|
// stdout: string, ← ExecResult.Stdout
|
|
// stderr: string, ← ExecResult.Stderr
|
|
// duration_ms: number, ← ExecResult.DurationMs (Host fills; Box = 0)
|
|
// error: string, ← ExecResult.Error (Host fills; Box = "")
|
|
// truncated: boolean ← ExecResult.Truncated (Host fills; Box = false)
|
|
// }
|
|
//
|
|
// box.Stream(cmd, callback) / box.Stream(cmd, options, callback)
|
|
//
|
|
// Go: Computer.Stream(ctx, cmd []string, opts ...ExecOption) (*ExecStream, error)
|
|
//
|
|
// Blocks until the process exits. The last argument must be a JS function.
|
|
// Callback signature: function(type, data)
|
|
// type = "stdout" → data is string (chunk)
|
|
// type = "stderr" → data is string (chunk)
|
|
// type = "exit" → data is number (exit code)
|
|
//
|
|
// box.VNC() → string
|
|
//
|
|
// Go: Computer.VNC(ctx) (string, error)
|
|
// Returns: VNC WebSocket URL
|
|
//
|
|
// box.Proxy(port, path?) → string
|
|
//
|
|
// Go: Computer.Proxy(ctx, port int, path string) (string, error)
|
|
// Returns: HTTP proxy URL
|
|
//
|
|
// box.ComputerInfo() → ComputerInfo
|
|
//
|
|
// Go: Computer.ComputerInfo() ComputerInfo
|
|
// JS returns: {
|
|
// kind: "box", pool, status,
|
|
// box_id, container_id, owner, image, policy, labels, ...
|
|
// }
|
|
//
|
|
// box.BindWorkplace(workspaceID) → void
|
|
//
|
|
// Go: Computer.BindWorkplace(workspaceID string)
|
|
//
|
|
// box.Workplace() → WorkspaceFS | null
|
|
//
|
|
// Go: Computer.Workplace() workspace.FS
|
|
//
|
|
// # Methods — Box-specific
|
|
//
|
|
// box.Attach(port, options?) → string
|
|
//
|
|
// Go: Proxy.URL(ctx, containerID, port, path) (string, error)
|
|
//
|
|
// Returns the service URL string.
|
|
// JS args:
|
|
// port: number → port int
|
|
// options: { → AttachOption
|
|
// protocol: "ws"|"sse", → affects URL scheme
|
|
// path: string, → URL path suffix
|
|
// }
|
|
// JS returns: string (URL)
|
|
//
|
|
// box.Workspace() → WorkspaceFS
|
|
//
|
|
// Implemented in workspace/jsapi package. Calls:
|
|
// workspace.NewFSObject(v8ctx, box.WorkspaceID())
|
|
//
|
|
// box.Info() → BoxInfo
|
|
//
|
|
// Go: Box.Info(ctx) (*BoxInfo, error)
|
|
// JS returns: {
|
|
// id, container_id, pool, owner, status, image, vnc, policy,
|
|
// labels, created_at, last_active, process_count
|
|
// }
|
|
//
|
|
// box.Start() → void
|
|
//
|
|
// Go: Box.Start(ctx) error
|
|
//
|
|
// box.Stop() → void
|
|
//
|
|
// Go: Box.Stop(ctx) error
|
|
//
|
|
// box.Remove() → void
|
|
//
|
|
// Go: Box.Remove(ctx) error
|
|
func NewBoxObject(v8ctx *v8go.Context, boxID string) (*v8go.Value, error) {
|
|
// TODO: Phase 2 implementation
|
|
// 1. Create JS object via v8go.NewObjectTemplate
|
|
// 2. Set read-only properties: id, owner, pool (from sandbox.M().Get(boxID))
|
|
// 3. Bind Computer interface methods:
|
|
// - Exec, Stream, VNC, Proxy, ComputerInfo, BindWorkplace, Workplace
|
|
// 4. Bind Box-specific methods:
|
|
// - Attach → client.Proxy().URL(ctx, containerID, port, path) → string
|
|
// - Workspace → NewFSObject(v8ctx, sandbox.M().Get(id).WorkspaceID())
|
|
// - Info → sandbox.M().Get(id).Info(ctx) → JS object
|
|
// - Start → sandbox.M().Get(id).Start(ctx)
|
|
// - Stop → sandbox.M().Get(id).Stop(ctx)
|
|
// - Remove → sandbox.M().Get(id).Remove(ctx)
|
|
return nil, nil
|
|
}
|