@mukae/contract 0.0.0-stage → 0.1.0-beta.0

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export declare const defaultGatewayPort = 47321;
+export declare const gatewayPortCandidates: readonly number[];
+export declare const launchScheme = "mukae";
+export declare const launchCommand = "connect";
+export declare const statusPath = "/status";
+export declare const acpPath = "/acp";
+export declare const gatewayStatuses: readonly ["waiting", "choosing", "unconfigured", "cancelled"];
+export type GatewayStatus = (typeof gatewayStatuses)[number];
+export declare const launchAgentTypes: readonly ["claude-acp", "codex-acp", "gemini", "opencode"];
+export type LaunchAgentType = (typeof launchAgentTypes)[number];
+export type AgentSlot = {
+    name: string;
+    agentType: string;
+};
+export type AgentSlotSelection = {
+    result: "use";
+    name: string;
+} | {
+    result: "choose";
+    names: readonly string[];
+} | {
+    result: "unconfigured";
+};
+export declare function buildLaunchUrl(input: {
+    nonce: string;
+    origin: string;
+    agentType: string;
+    port: number;
+}): string;
+export type LaunchRequest = {
+    nonce: string;
+    origin: string;
+    agentType: string;
+    port: number;
+};
+export declare function parseLaunchUrl(value: string): LaunchRequest | undefined;
+export declare function isGatewayPort(value: number): boolean;
+export declare function isNonce(value: string): boolean;
+export declare function isAgentType(value: string): boolean;
+export declare function isHttpOrigin(value: string): boolean;
+export declare function selectAgentSlots(input: {
+    agentType: string;
+    slots: readonly AgentSlot[];
+}): AgentSlotSelection;
+export declare function parseStatusBody(value: unknown): GatewayStatus | undefined;
+export declare function buildStatusUrl(port: number): string;
+export declare function buildWebSocketUrl(input: {
+    port: number;
+    nonce: string;
+}): string;

package/dist/index.js

@@ -0,0 +1,88 @@
+export const defaultGatewayPort = 47321;
+// Each connection runs its own gateway process on one port from this list.
+export const gatewayPortCandidates = Array.from({ length: 20 }, (_, index) => defaultGatewayPort + index);
+export const launchScheme = "mukae";
+export const launchCommand = "connect";
+export const statusPath = "/status";
+export const acpPath = "/acp";
+export const gatewayStatuses = ["waiting", "choosing", "unconfigured", "cancelled"];
+export const launchAgentTypes = ["claude-acp", "codex-acp", "gemini", "opencode"];
+const noncePattern = /^[A-Za-z0-9_-]{8,128}$/;
+const agentTypePattern = /^[a-z][a-z0-9-]{0,63}$/;
+export function buildLaunchUrl(input) {
+    const url = new URL(`${launchScheme}://${launchCommand}`);
+    url.searchParams.set("nonce", input.nonce);
+    url.searchParams.set("origin", input.origin);
+    url.searchParams.set("agentType", input.agentType);
+    url.searchParams.set("port", String(input.port));
+    return url.toString();
+}
+export function parseLaunchUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+    if (url.protocol !== `${launchScheme}:` || url.hostname !== launchCommand) {
+        return undefined;
+    }
+    const nonce = url.searchParams.get("nonce");
+    const origin = url.searchParams.get("origin");
+    const agentType = url.searchParams.get("agentType");
+    const port = Number(url.searchParams.get("port"));
+    if (!nonce ||
+        !isNonce(nonce) ||
+        !origin ||
+        !isHttpOrigin(origin) ||
+        !agentType ||
+        !isAgentType(agentType) ||
+        !isGatewayPort(port)) {
+        return undefined;
+    }
+    return { nonce, origin, agentType, port };
+}
+export function isGatewayPort(value) {
+    return gatewayPortCandidates.includes(value);
+}
+export function isNonce(value) {
+    return noncePattern.test(value);
+}
+export function isAgentType(value) {
+    return agentTypePattern.test(value);
+}
+export function isHttpOrigin(value) {
+    try {
+        const url = new URL(value);
+        return (url.protocol === "http:" || url.protocol === "https:") && url.origin === value;
+    }
+    catch {
+        return false;
+    }
+}
+export function selectAgentSlots(input) {
+    const names = input.slots.filter((slot) => slot.agentType === input.agentType).map((slot) => slot.name);
+    const onlyName = names[0];
+    if (names.length === 0 || onlyName === undefined)
+        return { result: "unconfigured" };
+    if (names.length === 1)
+        return { result: "use", name: onlyName };
+    return { result: "choose", names };
+}
+export function parseStatusBody(value) {
+    if (typeof value !== "object" || value === null || !("status" in value)) {
+        return undefined;
+    }
+    const status = value.status;
+    return gatewayStatuses.find((candidate) => candidate === status);
+}
+export function buildStatusUrl(port) {
+    return `http://127.0.0.1:${port}${statusPath}`;
+}
+export function buildWebSocketUrl(input) {
+    const url = new URL(`ws://127.0.0.1:${input.port}${acpPath}`);
+    url.searchParams.set("nonce", input.nonce);
+    return url.toString();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAsB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,GAAG,KAAK,CAAC,CAAC;AAC7H,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC;AAE9B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAG3F,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAC9C,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAYlD,MAAM,UAAU,cAAc,CAAC,KAAyE;IACtG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,YAAY,MAAM,aAAa,EAAE,CAAC,CAAC;IAC1D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAID,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,IACE,CAAC,KAAK;QACN,CAAC,OAAO,CAAC,KAAK,CAAC;QACf,CAAC,MAAM;QACP,CAAC,YAAY,CAAC,MAAM,CAAC;QACrB,CAAC,SAAS;QACV,CAAC,WAAW,CAAC,SAAS,CAAC;QACvB,CAAC,aAAa,CAAC,IAAI,CAAC,EACpB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyD;IACxF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxG,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACpF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,oBAAoB,IAAI,GAAG,UAAU,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAsC;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,kBAAkB,KAAK,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@mukae/contract",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-beta.0",
+  "description": "Launch URL, ports, and status values for mukae.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lulu0119/mukae.git",
+    "directory": "packages/contract"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && printf '%s\n' '*.test.js' '*.test.js.map' '*.test.d.ts' '*.test.d.ts.map' '*.tsbuildinfo' > dist/.npmignore",
+    "test": "tsc -p tsconfig.json && node --test dist/contract.test.js"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.