@stage-labs/metro 0.1.0-beta.50 → 0.1.0-beta.52

package/runtime/node_modules/@metro-labs/mcp/src/daemon/cli-pair-api.ts

@@ -1,141 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { log } from './log.js';
-import {
-  agentIdentity,
-  apiFailure,
-  assertLease,
-  bodyField,
-  cors,
-  readJsonBody,
-  sendJson,
-} from './api-http.js';
-import { extractToken } from '../mcp/request-identity.js';
-import { publicBaseOrDefault } from './attach-serve.js';
-import { AGENT_CODE_RE, takeAgentCode } from './agent-pair.js';
-import { relayServersJson } from './connector-json.js';
-import { SESSION_TTL_SEC } from './session-config.js';
-import { signAgentToken } from './session.js';
-import type { ConnectorApiDeps } from './connector-api.js';
-
-const CLAIM_PATH = '/api/cli/claim';
-const MCP_PATH = '/api/cli/mcp';
-const SESSION_PATH = '/api/cli/session';
-const CONNECTORS_PATH = '/api/cli/connectors';
-
-const ALLOWED: Record<string, string> = {
-  [CLAIM_PATH]: 'POST',
-  [MCP_PATH]: 'GET',
-  [SESSION_PATH]: 'GET',
-  [CONNECTORS_PATH]: 'GET',
-};
-
-function secretOrNull(): string | null {
-  const secret = process.env.METRO_SESSION_SECRET?.trim() ?? '';
-  return secret === '' ? null : secret;
-}
-
-async function handleClaim(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ConnectorApiDeps,
-): Promise<void> {
-  const secret = secretOrNull();
-  if (secret === null) {
-    sendJson(req, res, 503, { error: 'sign-in is not configured' });
-    return;
-  }
-  const raw = bodyField(await readJsonBody(req), 'code');
-  const code = typeof raw === 'string' ? raw.trim() : '';
-  if (!AGENT_CODE_RE.test(code)) {
-    sendJson(req, res, 400, {
-      error:
-        'that does not look like an agent code — metro login wants the ma_… code from the agent page',
-    });
-    return;
-  }
-  const taken = takeAgentCode(code);
-  if (taken === undefined) {
-    sendJson(req, res, 400, {
-      error: 'that code has expired or was already used',
-    });
-    return;
-  }
-  const agent = await deps.agentConnectors(taken.subject, taken.agentId);
-  const token = signAgentToken(
-    { subject: taken.subject, agentId: agent.id },
-    secret,
-    { ttlSec: SESSION_TTL_SEC },
-  );
-  log.info({ subject: taken.subject, agent: agent.id }, 'cli: code claimed');
-  sendJson(req, res, 200, {
-    token,
-    subject: taken.subject,
-    agent: agent.name,
-  });
-}
-
-async function handleRead(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ConnectorApiDeps,
-  path: string,
-): Promise<void> {
-  const who = agentIdentity(req);
-  if (who === null) {
-    sendJson(req, res, 401, { error: 'unauthorized' });
-    return;
-  }
-  await assertLease(who, deps.fenceRuntime);
-  const agent = await deps.agentConnectors(who.subject, who.agentId);
-  if (path === SESSION_PATH) {
-    sendJson(req, res, 200, {
-      subject: who.subject,
-      agent: agent.name,
-    });
-    return;
-  }
-  if (path === CONNECTORS_PATH) {
-    sendJson(req, res, 200, {
-      agent: agent.name,
-      connectors: await deps.connectorSummariesByIds(agent.connectorIds),
-    });
-    return;
-  }
-  const entries = await deps.connectorNamesByIds(agent.connectorIds);
-  const json = relayServersJson(
-    entries,
-    publicBaseOrDefault(),
-    extractToken(req) ?? '',
-  );
-  sendJson(req, res, 200, { json, agent: agent.name });
-}
-
-export function handleCliPairRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ConnectorApiDeps,
-): boolean {
-  const path = (req.url ?? '').split('?')[0] ?? '';
-  const method = ALLOWED[path];
-  if (method === undefined) {
-    if (!path.startsWith('/api/cli/') && path !== '/api/cli') return false;
-    sendJson(req, res, 404, { error: 'no such route' });
-    return true;
-  }
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, cors(req)).end();
-    return true;
-  }
-  if (req.method !== method) {
-    sendJson(req, res, 405, { error: 'method not allowed' });
-    return true;
-  }
-  const work =
-    path === CLAIM_PATH
-      ? handleClaim(req, res, deps)
-      : handleRead(req, res, deps, path);
-  work.catch((err: unknown) => {
-    apiFailure(req, res, err, 'cli');
-  });
-  return true;
-}

package/runtime/node_modules/@metro-labs/mcp/src/daemon/import-api.ts

@@ -1,68 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { errMsg, log } from './log.js';
-import {
-  apiFailure,
-  apiSession,
-  bodyField,
-  cors,
-  readJsonBody,
-  sendJson,
-} from './api-http.js';
-import { parsePairingCode } from './agent-import.js';
-import type { CreatedAgent } from '../db/agent-admin.js';
-
-const PATH = '/api/agents/import';
-
-export interface ImportedAgent extends CreatedAgent {
-  stations: number;
-  connectors: number;
-}
-
-export interface ImportApiDeps {
-  importAgent: (subject: string, code: string) => Promise<ImportedAgent>;
-}
-
-async function handle(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ImportApiDeps,
-  subject: string,
-): Promise<void> {
-  try {
-    const code = parsePairingCode(bodyField(await readJsonBody(req), 'code'));
-    const made = await deps.importAgent(subject, code);
-    log.info(
-      { agent: made.name, id: made.id, stations: made.stations, connectors: made.connectors },
-      'import-api: agent imported from metro',
-    );
-    sendJson(req, res, 201, made);
-  } catch (err) {
-    apiFailure(req, res, err, 'import-api');
-  }
-}
-
-export function handleImportRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ImportApiDeps,
-): boolean {
-  if ((req.url ?? '').split('?')[0] !== PATH) return false;
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, cors(req)).end();
-    return true;
-  }
-  if (req.method !== 'POST') {
-    sendJson(req, res, 405, { error: 'method not allowed' });
-    return true;
-  }
-  const session = apiSession(req);
-  if (!session) {
-    sendJson(req, res, 401, { error: 'unauthorized' });
-    return true;
-  }
-  handle(req, res, deps, session.subject).catch((err: unknown) => {
-    log.warn({ err: errMsg(err) }, 'import-api: unhandled error');
-    if (!res.headersSent) sendJson(req, res, 500, { error: 'import failed' });
-  });
-  return true;
-}

package/runtime/node_modules/@metro-labs/mcp/src/daemon/pair-codes.ts

@@ -1,58 +0,0 @@
-import { randomBytes } from 'node:crypto';
-
-const TTL_MS = 10 * 60_000;
-const SWEEP_MS = 60_000;
-const MAX_CODES = 100;
-
-export interface CodeStore<T> {
-  pattern: RegExp;
-  mint(entry: T, now?: number): { code: string; expiresAt: number };
-  take(code: string, now?: number): T | undefined;
-  count(): number;
-}
-
-export function makeCodeStore<T extends object>(prefix: string): CodeStore<T> {
-  const codes = new Map<string, T & { expiresAt: number }>();
-  let sweeper: ReturnType<typeof setInterval> | null = null;
-
-  const sweep = (now = Date.now()): void => {
-    for (const [code, entry] of codes)
-      if (entry.expiresAt <= now) codes.delete(code);
-  };
-
-  const ensureSweeper = (): void => {
-    if (sweeper !== null) return;
-    sweeper = setInterval(sweep, SWEEP_MS);
-    sweeper.unref?.();
-  };
-
-  return {
-    pattern: new RegExp(`^${prefix}_[A-Za-z0-9_-]{16}$`),
-    mint(entry, now = Date.now()) {
-      sweep(now);
-      while (codes.size >= MAX_CODES) {
-        const oldest = codes.keys().next();
-        if (oldest.done) break;
-        codes.delete(oldest.value);
-      }
-      const code = `${prefix}_${randomBytes(12).toString('base64url')}`;
-      const expiresAt = now + TTL_MS;
-      codes.set(code, { ...entry, expiresAt });
-      ensureSweeper();
-      return { code, expiresAt };
-    },
-    take(code, now = Date.now()) {
-      const entry = codes.get(code);
-      if (entry === undefined) return undefined;
-      codes.delete(code);
-      if (entry.expiresAt <= now) return undefined;
-      const rest: Record<string, unknown> = { ...entry };
-      delete rest.expiresAt;
-      return rest as T;
-    },
-    count() {
-      sweep();
-      return codes.size;
-    },
-  };
-}

package/runtime/node_modules/@metro-labs/mcp/src/daemon/project-api.ts

@@ -1,214 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { errMsg, log } from './log.js';
-import {
-  apiFailure,
-  apiSession,
-  bodyField,
-  cors,
-  readJsonBody,
-  sendJson,
-  type ApiSession,
-} from './api-http.js';
-import { parseId } from '../db/ids.js';
-import type { Member, Project } from '../db/projects.js';
-
-const PREFIX = '/api/projects';
-
-export interface ProjectApiDeps {
-  listProjects: (subject: string) => Promise<Project[]>;
-  createProject: (subject: string, name: unknown) => Promise<Project>;
-  renameProject: (
-    subject: string,
-    id: string,
-    name: unknown,
-  ) => Promise<Project>;
-  deleteProject: (
-    subject: string,
-    id: string,
-  ) => Promise<{ id: string; name: string }>;
-  listMembers: (subject: string, id: string) => Promise<Member[]>;
-  addMember: (
-    subject: string,
-    id: string,
-    invited: unknown,
-    role: unknown,
-  ) => Promise<Member[]>;
-  setMemberRole: (
-    subject: string,
-    id: string,
-    memberId: string,
-    role: unknown,
-  ) => Promise<Member[]>;
-  removeMember: (
-    subject: string,
-    id: string,
-    memberId: string,
-  ) => Promise<Member[]>;
-}
-
-type Routable =
-  | { kind: 'index' }
-  | { kind: 'project'; id: string }
-  | { kind: 'rename'; id: string }
-  | { kind: 'members'; id: string }
-  | { kind: 'member'; id: string; memberId: string };
-
-type Target = Routable | { kind: 'unknown' } | null;
-
-const ALLOWED: Record<Routable['kind'], string[]> = {
-  index: ['GET', 'POST'],
-  project: ['DELETE'],
-  rename: ['POST'],
-  members: ['GET', 'POST'],
-  member: ['POST', 'DELETE'],
-};
-
-function memberTarget(id: string, rest: string[]): Target {
-  if (rest.length === 1) return { kind: 'members', id };
-  if (rest.length > 2) return { kind: 'unknown' };
-  const memberId = parseId(rest[1] ?? '');
-  return memberId === null
-    ? { kind: 'unknown' }
-    : { kind: 'member', id, memberId };
-}
-
-function subTarget(id: string, rest: string[]): Target {
-  if (rest.length === 0) return { kind: 'project', id };
-  const head = rest[0];
-  if (head === 'members') return memberTarget(id, rest);
-  if (rest.length > 1) return { kind: 'unknown' };
-  if (head === 'rename') return { kind: 'rename', id };
-  return { kind: 'unknown' };
-}
-
-function target(path: string): Target {
-  if (path === PREFIX || path === `${PREFIX}/`) return { kind: 'index' };
-  if (!path.startsWith(`${PREFIX}/`)) return null;
-  const segments = path.slice(PREFIX.length + 1).split('/').filter(Boolean);
-  const head = segments[0];
-  if (head === undefined) return { kind: 'index' };
-  const id = parseId(head);
-  return id === null ? { kind: 'unknown' } : subTarget(id, segments.slice(1));
-}
-
-async function handleIndex(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ProjectApiDeps,
-  session: ApiSession,
-): Promise<void> {
-  if (req.method === 'GET') {
-    sendJson(req, res, 200, { projects: await deps.listProjects(session.subject) });
-    return;
-  }
-  const made = await deps.createProject(
-    session.subject,
-    bodyField(await readJsonBody(req), 'name'),
-  );
-  log.info({ id: made.id, name: made.name }, 'project-api: created project');
-  sendJson(req, res, 201, made);
-}
-
-async function handleMembers(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ProjectApiDeps,
-  session: ApiSession,
-  id: string,
-): Promise<void> {
-  if (req.method === 'GET') {
-    sendJson(req, res, 200, { members: await deps.listMembers(session.subject, id) });
-    return;
-  }
-  const body = await readJsonBody(req);
-  const members = await deps.addMember(
-    session.subject,
-    id,
-    bodyField(body, 'address'),
-    bodyField(body, 'role'),
-  );
-  sendJson(req, res, 200, { members });
-}
-
-async function handleMember(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ProjectApiDeps,
-  session: ApiSession,
-  tgt: { id: string; memberId: string },
-): Promise<void> {
-  if (req.method === 'DELETE') {
-    const members = await deps.removeMember(session.subject, tgt.id, tgt.memberId);
-    sendJson(req, res, 200, { members });
-    return;
-  }
-  const members = await deps.setMemberRole(
-    session.subject,
-    tgt.id,
-    tgt.memberId,
-    bodyField(await readJsonBody(req), 'role'),
-  );
-  sendJson(req, res, 200, { members });
-}
-
-async function route(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ProjectApiDeps,
-  session: ApiSession,
-  tgt: Routable,
-): Promise<void> {
-  try {
-    if (tgt.kind === 'index') await handleIndex(req, res, deps, session);
-    else if (tgt.kind === 'members')
-      await handleMembers(req, res, deps, session, tgt.id);
-    else if (tgt.kind === 'member')
-      await handleMember(req, res, deps, session, tgt);
-    else if (tgt.kind === 'rename')
-      sendJson(
-        req,
-        res,
-        200,
-        await deps.renameProject(
-          session.subject,
-          tgt.id,
-          bodyField(await readJsonBody(req), 'name'),
-        ),
-      );
-    else sendJson(req, res, 200, await deps.deleteProject(session.subject, tgt.id));
-  } catch (err) {
-    apiFailure(req, res, err, 'project-api');
-  }
-}
-
-export function handleProjectApiRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: ProjectApiDeps,
-): boolean {
-  const tgt = target((req.url ?? '').split('?')[0] ?? '');
-  if (tgt === null) return false;
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, cors(req)).end();
-    return true;
-  }
-  if (tgt.kind === 'unknown') {
-    sendJson(req, res, 404, { error: 'no such project' });
-    return true;
-  }
-  if (!ALLOWED[tgt.kind].includes(req.method ?? '')) {
-    sendJson(req, res, 405, { error: 'method not allowed' });
-    return true;
-  }
-  const session = apiSession(req);
-  if (!session) {
-    sendJson(req, res, 401, { error: 'unauthorized' });
-    return true;
-  }
-  route(req, res, deps, session, tgt).catch((err: unknown) => {
-    log.warn({ err: errMsg(err) }, 'project-api: unhandled error');
-    if (!res.headersSent)
-      sendJson(req, res, 500, { error: 'project api failed' });
-  });
-  return true;
-}

package/runtime/node_modules/@metro-labs/mcp/src/daemon/run-api.ts

@@ -1,139 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { log } from './log.js';
-import {
-  apiFailure,
-  bodyField,
-  cors,
-  readJsonBody,
-  runIdentity,
-  sendJson,
-} from './api-http.js';
-import { AGENT_CODE_RE, takeAgentCode } from './agent-pair.js';
-import { SESSION_TTL_SEC } from './session-config.js';
-import { signRunToken } from './session.js';
-import type { LoadedAgent } from '../db/materialize.js';
-import type { RuntimeLease } from '../db/runtimes.js';
-
-const CLAIM_PATH = '/api/run/claim';
-const CONFIG_PATH = '/api/run/config';
-
-const ALLOWED: Record<string, string> = {
-  [CLAIM_PATH]: 'POST',
-  [CONFIG_PATH]: 'GET',
-};
-
-export interface RunApiDeps {
-  claimRuntime: (agentId: string, label: string) => Promise<RuntimeLease>;
-  fenceRuntime: (runtimeId: string, agentId: string) => Promise<void>;
-  touchRuntime: (runtimeId: string) => Promise<void>;
-  loadAgent: (agentId: string) => Promise<LoadedAgent>;
-  blockedStations: (agentId: string) => Promise<string[]>;
-}
-
-function secretOrNull(): string | null {
-  const secret = process.env.METRO_SESSION_SECRET?.trim() ?? '';
-  return secret === '' ? null : secret;
-}
-
-function labelOf(body: unknown): string {
-  const raw = bodyField(body, 'label');
-  const label = typeof raw === 'string' ? raw.trim().slice(0, 64) : '';
-  return label === '' ? 'unnamed machine' : label;
-}
-
-async function handleClaim(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: RunApiDeps,
-): Promise<void> {
-  const secret = secretOrNull();
-  if (secret === null) {
-    sendJson(req, res, 503, { error: 'sign-in is not configured' });
-    return;
-  }
-  const body = await readJsonBody(req);
-  const raw = bodyField(body, 'code');
-  const code = typeof raw === 'string' ? raw.trim() : '';
-  if (!AGENT_CODE_RE.test(code)) {
-    sendJson(req, res, 400, {
-      error:
-        'that does not look like an agent code — metro start wants the ma_… code from the agent page',
-    });
-    return;
-  }
-  const taken = takeAgentCode(code);
-  if (taken === undefined) {
-    sendJson(req, res, 400, {
-      error: 'that code has expired or was already used',
-    });
-    return;
-  }
-  const blocked = await deps.blockedStations(taken.agentId);
-  if (blocked.length > 0) {
-    sendJson(req, res, 409, {
-      error:
-        `this agent holds ${blocked.join(', ')}, which only runs on metro because a webhook url has to be publicly reachable. Detach it, or move it to a second agent that stays on metro, then start this one.`,
-    });
-    return;
-  }
-  const lease = await deps.claimRuntime(taken.agentId, labelOf(body));
-  const token = signRunToken(
-    { subject: taken.subject, agentId: lease.agentId, runtimeId: lease.runtimeId },
-    secret,
-    { ttlSec: SESSION_TTL_SEC },
-  );
-  log.info(
-    { agent: lease.agentId, runtime: lease.runtimeId, label: lease.label },
-    'run: agent claimed by a local runtime',
-  );
-  sendJson(req, res, 200, {
-    token,
-    agent: lease.agentId,
-    label: lease.label,
-  });
-}
-
-async function handleConfig(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: RunApiDeps,
-): Promise<void> {
-  const who = runIdentity(req);
-  if (who === null) {
-    sendJson(req, res, 401, { error: 'unauthorized' });
-    return;
-  }
-  await deps.fenceRuntime(who.runtimeId, who.agentId);
-  await deps.touchRuntime(who.runtimeId);
-  sendJson(req, res, 200, { agent: await deps.loadAgent(who.agentId) });
-}
-
-export function handleRunApiRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  deps: RunApiDeps,
-): boolean {
-  const path = (req.url ?? '').split('?')[0] ?? '';
-  const method = ALLOWED[path];
-  if (method === undefined) {
-    if (!path.startsWith('/api/run/') && path !== '/api/run') return false;
-    sendJson(req, res, 404, { error: 'no such route' });
-    return true;
-  }
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, cors(req)).end();
-    return true;
-  }
-  if (req.method !== method) {
-    sendJson(req, res, 405, { error: 'method not allowed' });
-    return true;
-  }
-  const work =
-    path === CLAIM_PATH
-      ? handleClaim(req, res, deps)
-      : handleConfig(req, res, deps);
-  work.catch((err: unknown) => {
-    apiFailure(req, res, err, 'run-api');
-  });
-  return true;
-}