@schoolai/shipyard 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @schoolai/shipyard
+
+Ship responsibly. Agent management hub for human-agent collaboration.
+
+Shipyard is the collaboration workspace for mixed human-agent teams. Agents create tasks with proof. Humans review in real-time. Feedback flows both ways.
+
+## Install
+
+```bash
+npm install -g @schoolai/shipyard@latest
+```
+
+Or run directly:
+
+```bash
+npx @schoolai/shipyard --help
+```
+
+## Authentication
+
+```bash
+shipyard login              # Device flow auth (opens browser)
+shipyard login --check      # Check current auth status
+shipyard logout             # Clear stored credentials
+```
+
+## Usage
+
+```bash
+# Run a task with a prompt
+shipyard --prompt "Fix the bug in auth.ts"
+
+# Resume an existing session
+shipyard --resume <session-id> --task-id <id>
+
+# Run in serve mode (signaling + agent spawning)
+shipyard --serve
+
+# Check version
+shipyard --version
+```
+
+## CLI Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--prompt <text>` | `-p` | Prompt for the agent |
+| `--task-id <id>` | `-t` | Task ID (auto-generated if omitted) |
+| `--resume <id>` | `-r` | Resume session by session ID |
+| `--data-dir <path>` | `-d` | Data directory (default: `~/.shipyard/data`) |
+| `--cwd <path>` | | Working directory for agent |
+| `--model <name>` | `-m` | Model to use |
+| `--serve` | `-s` | Run in serve mode |
+| `--version` | `-v` | Show version |
+| `--help` | `-h` | Show help |
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ANTHROPIC_API_KEY` | | API key for Claude (optional, overrides OAuth) |
+| `SHIPYARD_DEV` | | Set to `1` for dev mode |
+| `SHIPYARD_DATA_DIR` | `~/.shipyard/data` | Data directory |
+| `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, `error` |
+| `SHIPYARD_SIGNALING_URL` | (auto) | Signaling server WebSocket URL |
+
+## Documentation
+
+- [Installation Guide](https://github.com/SchoolAI/shipyard/blob/main/docs/installation.md)
+- [Architecture](https://github.com/SchoolAI/shipyard/blob/main/docs/architecture.md)
+- [Development](https://github.com/SchoolAI/shipyard/blob/main/docs/development.md)
+
+## License
+
+[FSL-1.1-ALv2](https://github.com/SchoolAI/shipyard/blob/main/LICENSE.md) (Functional Source License) - Free for all non-competing use, converts to Apache 2.0 in 2 years.

package/dist/{chunk-FNYWUFGS.js → chunk-4IVLSSKL.js}

@@ -4122,7 +4122,13 @@ var AuthVerifyResponseSchema = external_exports.discriminatedUnion("valid", [
     reason: external_exports.enum(["invalid_token", "user_not_found"])
   })
 ]);
-var CollaboratorRoleSchema = external_exports.enum([
+var ParticipantRoleSchema = external_exports.enum([
+  "owner",
+  "collaborator-full",
+  "collaborator-review",
+  "viewer"
+]);
+var CollaboratorRoleSchema = ParticipantRoleSchema.extract([
   "collaborator-full",
   "collaborator-review",
   "viewer"
@@ -4130,8 +4136,8 @@ var CollaboratorRoleSchema = external_exports.enum([
 var CollabCreateRequestSchema = external_exports.object({
   /** ID of the task to collaborate on */
   taskId: external_exports.string().min(1, "taskId is required"),
-  /** How long the collaboration link should be valid (1-1440 minutes, default 60) */
-  expiresInMinutes: external_exports.number().min(1).max(1440).default(60),
+  /** How long the collaboration link should be valid (1-10080 minutes / 7 days max, default 60) */
+  expiresInMinutes: external_exports.number().min(1).max(10080).default(60),
   /** Permission level for the invitee (defaults to 'collaborator-full') */
   role: CollaboratorRoleSchema.optional()
 });
@@ -4274,6 +4280,15 @@ var NotifyTaskSchema = external_exports.object({
   machineId: external_exports.string(),
   taskId: external_exports.string()
 });
+var NotifyCollabRoomSchema = external_exports.object({
+  type: external_exports.literal("notify-collab-room"),
+  requestId: external_exports.string(),
+  machineId: external_exports.string(),
+  taskId: external_exports.string(),
+  roomId: external_exports.string(),
+  token: external_exports.string().min(1),
+  expiresAt: external_exports.number().positive()
+});
 var TaskAckSchema = external_exports.object({
   type: external_exports.literal("task-ack"),
   requestId: external_exports.string(),
@@ -4362,6 +4377,7 @@ var PersonalRoomClientMessageSchema = external_exports.discriminatedUnion("type"
   WebRTCAnswerSchema,
   WebRTCIceSchema,
   NotifyTaskSchema,
+  NotifyCollabRoomSchema,
   TaskAckSchema,
   CancelTaskSchema,
   ControlAckSchema,
@@ -4412,6 +4428,7 @@ var PersonalRoomServerMessageSchema = external_exports.discriminatedUnion("type"
   AgentLeftSchema,
   AgentStatusChangedSchema,
   NotifyTaskSchema,
+  NotifyCollabRoomSchema,
   TaskAckSchema,
   CancelTaskSchema,
   ControlAckSchema,
@@ -4451,7 +4468,7 @@ var ParticipantSchema = external_exports.object({
   userId: external_exports.string(),
   username: external_exports.string(),
   avatarUrl: external_exports.string().nullable().optional(),
-  role: external_exports.enum(["owner", "collaborator-full", "collaborator-review", "viewer"])
+  role: ParticipantRoleSchema
 });
 var CollabAuthenticatedSchema = external_exports.object({
   type: external_exports.literal("authenticated"),
@@ -4499,6 +4516,164 @@ var DevicePollPendingSchema = external_exports.object({
   error: external_exports.enum(["authorization_pending", "slow_down", "expired_token"])
 });
 
+// ../../packages/session/src/collab-room-connection.ts
+var CollabRoomConnection = class {
+  state = "disconnected";
+  ws = null;
+  messageHandlers = /* @__PURE__ */ new Set();
+  stateChangeHandlers = /* @__PURE__ */ new Set();
+  config;
+  retryCount = 0;
+  retryTimer = null;
+  intentionalDisconnect = false;
+  constructor(config) {
+    this.config = config;
+  }
+  getState() {
+    return this.state;
+  }
+  connect() {
+    this.intentionalDisconnect = false;
+    if (this.retryTimer !== null) {
+      clearTimeout(this.retryTimer);
+      this.retryTimer = null;
+    }
+    if (this.ws) {
+      this.ws.onopen = null;
+      this.ws.onclose = null;
+      this.ws.onerror = null;
+      this.ws.onmessage = null;
+      this.ws.close();
+      this.ws = null;
+    }
+    const Impl = this.config.WebSocketImpl ?? WebSocket;
+    try {
+      this.ws = new Impl(this.config.url);
+    } catch {
+      this.setState("error");
+      this.reconnectWithBackoff();
+      return;
+    }
+    this.setState("connecting");
+    this.ws.onopen = () => {
+      this.setState("connected");
+    };
+    this.ws.onclose = (ev) => {
+      if (this.state !== "error" && this.state !== "reconnecting") {
+        this.setState("disconnected");
+      }
+      if (!this.intentionalDisconnect && extractCloseCode(ev) !== 4001) {
+        this.reconnectWithBackoff();
+      }
+    };
+    this.ws.onerror = () => {
+      this.setState("error");
+      if (!this.intentionalDisconnect) {
+        this.reconnectWithBackoff();
+      }
+    };
+    this.ws.onmessage = (event) => {
+      let raw;
+      try {
+        raw = JSON.parse(event.data);
+      } catch {
+        return;
+      }
+      const result = CollabRoomServerMessageSchema.safeParse(raw);
+      if (!result.success) {
+        console.warn(
+          "[CollabRoom] Dropped unrecognized server message:",
+          JSON.stringify(raw),
+          result.error.issues
+        );
+        return;
+      }
+      for (const handler of [...this.messageHandlers]) {
+        handler(result.data);
+      }
+    };
+  }
+  send(msg) {
+    try {
+      this.ws?.send(JSON.stringify(msg));
+    } catch {
+    }
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+    return () => {
+      this.messageHandlers.delete(handler);
+    };
+  }
+  onStateChange(handler) {
+    this.stateChangeHandlers.add(handler);
+    return () => {
+      this.stateChangeHandlers.delete(handler);
+    };
+  }
+  reconnect() {
+    this.intentionalDisconnect = false;
+    if (this.retryTimer !== null) {
+      clearTimeout(this.retryTimer);
+      this.retryTimer = null;
+    }
+    this.retryCount = 0;
+    this.connect();
+  }
+  disconnect() {
+    this.intentionalDisconnect = true;
+    if (this.retryTimer !== null) {
+      clearTimeout(this.retryTimer);
+      this.retryTimer = null;
+    }
+    this.retryCount = 0;
+    if (this.ws) {
+      this.ws.onopen = null;
+      this.ws.onclose = null;
+      this.ws.onerror = null;
+      this.ws.onmessage = null;
+      this.ws.close();
+      this.ws = null;
+    }
+    this.setState("disconnected");
+  }
+  reconnectWithBackoff() {
+    if (this.retryTimer !== null) return;
+    const maxRetries = this.config.maxRetries;
+    if (maxRetries === void 0 || maxRetries === 0) {
+      return;
+    }
+    if (maxRetries !== -1 && this.retryCount >= maxRetries) {
+      return;
+    }
+    this.setState("reconnecting");
+    if (this.intentionalDisconnect) return;
+    const initialDelay = this.config.initialDelayMs ?? 1e3;
+    const maxDelay = this.config.maxDelayMs ?? 3e4;
+    const multiplier = this.config.backoffMultiplier ?? 2;
+    const delay = Math.min(initialDelay * multiplier ** this.retryCount, maxDelay);
+    this.retryCount++;
+    this.retryTimer = setTimeout(() => {
+      this.retryTimer = null;
+      this.connect();
+    }, delay);
+  }
+  setState(newState) {
+    this.state = newState;
+    if (newState === "connected") {
+      this.retryCount = 0;
+    }
+    for (const handler of [...this.stateChangeHandlers]) {
+      handler(newState);
+    }
+  }
+};
+function extractCloseCode(ev) {
+  if (typeof ev !== "object" || ev === null || !("code" in ev)) return void 0;
+  const code = ev.code;
+  return typeof code === "number" ? code : void 0;
+}
+
 // ../../packages/session/src/personal-room-connection.ts
 var PersonalRoomConnection = class {
   state = "disconnected";
@@ -4564,6 +4739,11 @@ var PersonalRoomConnection = class {
       }
       const result = PersonalRoomServerMessageSchema.safeParse(raw);
       if (!result.success) {
+        console.warn(
+          "[PersonalRoom] Dropped unrecognized server message:",
+          JSON.stringify(raw),
+          result.error.issues
+        );
         return;
       }
       for (const handler of [...this.messageHandlers]) {
@@ -4589,6 +4769,15 @@ var PersonalRoomConnection = class {
       this.stateChangeHandlers.delete(handler);
     };
   }
+  reconnect() {
+    this.intentionalDisconnect = false;
+    if (this.retryTimer !== null) {
+      clearTimeout(this.retryTimer);
+      this.retryTimer = null;
+    }
+    this.retryCount = 0;
+    this.connect();
+  }
   disconnect() {
     this.intentionalDisconnect = true;
     if (this.retryTimer !== null) {
@@ -4650,6 +4839,7 @@ export {
   CollabCreateRequestSchema,
   CollabCreateResponseSchema,
   PermissionModeSchema,
+  CollabRoomConnection,
   PersonalRoomConnection
 };
-//# sourceMappingURL=chunk-FNYWUFGS.js.map
+//# sourceMappingURL=chunk-4IVLSSKL.js.map