@romanilyin/canonicalpath 2026.5.18-2

package/dist/unity-gateway/types.d.ts

@@ -0,0 +1,168 @@
+import type { CanonicalPath, CanonicalRelativePath, HostKind, NormalizeOptions } from "../canonicalpath/types.js";
+import type { UnityMcpWorkflowScope } from "./path-service.js";
+export interface UnityProjectPathAliasRegistration {
+    clientType: string;
+    clientId: string;
+    environmentId: string;
+    hostKind?: HostKind;
+    hostRoot: string;
+    normalizeOptions?: NormalizeOptions;
+    label?: string;
+}
+export interface UnityProjectPathAlias {
+    projectId: string;
+    canonicalProjectPath: CanonicalPath;
+    clientType: string;
+    clientId: string;
+    environmentId: string;
+    hostKind: HostKind;
+    hostRoot: string;
+    normalizeOptions?: NormalizeOptions;
+    label?: string;
+}
+export interface UnityProjectPathAliasSelector {
+    clientType?: string;
+    clientId?: string;
+    environmentId?: string;
+    hostKind?: HostKind;
+}
+export interface UnityProjectRegistration {
+    projectId: string;
+    projectRoot: string;
+    normalizeOptions?: NormalizeOptions;
+    hostRoot?: string;
+    aliases?: UnityProjectPathAliasRegistration[];
+}
+export interface UnityProjectRecord {
+    projectId: string;
+    canonicalProjectPath: CanonicalPath;
+    normalizeOptions?: NormalizeOptions;
+    hostRoot?: string;
+    pathAliases: UnityProjectPathAlias[];
+}
+export interface UnityBridgePathValidation {
+    ok: true;
+    projectId: string;
+    unityPath: CanonicalRelativePath;
+    canonicalPath: CanonicalPath;
+    safeFileName?: string;
+}
+export interface UnityBridgeStatus {
+    state: "ready" | "disconnected" | "error";
+    projectId?: string;
+    projectName?: string;
+    unityVersion?: string;
+    detail?: string;
+}
+export interface UnityBridgeProjectInfo {
+    projectId: string;
+    canonicalProjectPath: CanonicalPath;
+    hostRoot?: string;
+    pathAliases: UnityProjectPathAlias[];
+    projectName?: string;
+    unityVersion?: string;
+}
+export interface UnityBridgeLogEntry {
+    level: "trace" | "debug" | "info" | "warning" | "error";
+    message: string;
+    timestamp?: string;
+}
+export interface UnityBridgeReadResult {
+    projectId: string;
+    unityPath: CanonicalRelativePath;
+    canonicalPath: CanonicalPath;
+    text: string;
+    truncated: boolean;
+}
+export interface UnityMcpArtifactRef {
+    scope: "artifact";
+    path: CanonicalRelativePath;
+}
+export interface UnityBridgeScopedTextResult {
+    projectId: string;
+    scope: UnityMcpWorkflowScope;
+    path: CanonicalRelativePath;
+    projectRelativePath: CanonicalRelativePath;
+    text: string;
+    truncated: boolean;
+    artifactRef?: UnityMcpArtifactRef;
+}
+export interface UnityBridgeScopedWriteResult {
+    ok: true;
+    projectId: string;
+    scope: UnityMcpWorkflowScope;
+    path: CanonicalRelativePath;
+    projectRelativePath: CanonicalRelativePath;
+    chars: number;
+    artifactRef?: UnityMcpArtifactRef;
+}
+export interface UnityBridgeScopedEntry {
+    scope: UnityMcpWorkflowScope;
+    path: CanonicalRelativePath;
+    projectRelativePath: CanonicalRelativePath;
+    kind: "file";
+    chars: number;
+    artifactRef?: UnityMcpArtifactRef;
+}
+export interface UnityBridgeScopedListResult {
+    projectId: string;
+    scope: UnityMcpWorkflowScope;
+    pathPrefix?: CanonicalRelativePath;
+    entries: UnityBridgeScopedEntry[];
+    truncated: boolean;
+}
+export interface UnityBridgeScopedGlobResult {
+    projectId: string;
+    scope: UnityMcpWorkflowScope;
+    glob: CanonicalRelativePath;
+    entries: UnityBridgeScopedEntry[];
+    truncated: boolean;
+}
+export type UnityBridgeWriteCommand = "assets.refresh" | "scene.save" | "asset.import" | "prefab.create" | "module.create";
+export interface UnityBridgeWriteRequest {
+    projectId: string;
+    unityPath?: string;
+    generatedFileName?: string;
+    dryRun?: boolean;
+}
+export interface UnityBridgeWriteResult {
+    ok: true;
+    command: UnityBridgeWriteCommand;
+    projectId: string;
+    unityPath?: CanonicalRelativePath;
+    canonicalPath?: CanonicalPath;
+    safeFileName?: string;
+    dryRun: boolean;
+    performed: boolean;
+    detail?: string;
+}
+export interface UnityBridgeClient {
+    status(projectId?: string): Promise<UnityBridgeStatus>;
+    projectInfo(projectId: string): Promise<UnityBridgeProjectInfo>;
+    readLog(projectId?: string, maxEntries?: number): Promise<UnityBridgeLogEntry[]>;
+    readText(projectId: string, unityPath: string, maxChars?: number): Promise<UnityBridgeReadResult>;
+    readScopedText(projectId: string, scope: UnityMcpWorkflowScope, path: string, maxChars?: number): Promise<UnityBridgeScopedTextResult>;
+    writeScopedText(projectId: string, scope: UnityMcpWorkflowScope, path: string, text: string, maxChars?: number): Promise<UnityBridgeScopedWriteResult>;
+    listScoped(projectId: string, scope: UnityMcpWorkflowScope, pathPrefix?: string, maxEntries?: number): Promise<UnityBridgeScopedListResult>;
+    globScoped(projectId: string, scope: UnityMcpWorkflowScope, glob: string, maxEntries?: number): Promise<UnityBridgeScopedGlobResult>;
+    validatePath(projectId: string, unityPath: string, options?: UnityPathValidationOptions): Promise<UnityBridgePathValidation>;
+    writeCommand(command: UnityBridgeWriteCommand, request: UnityBridgeWriteRequest): Promise<UnityBridgeWriteResult>;
+}
+export interface UnityPathValidationOptions {
+    generatedFileName?: string;
+    maxFileNameLength?: number;
+}
+export interface McpToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: unknown;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/unity-gateway/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/unity-gateway/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,iCAAiC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,aAAa,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,iCAAiC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,aAAa,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAE3H,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChE,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvI,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACvJ,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC5I,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACrI,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7H,YAAY,CAAC,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACnH;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/unity-gateway/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/unity-gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/unity-gateway/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@romanilyin/canonicalpath",
+  "version": "2026.5.18-2",
+  "description": "Deterministic lexical path identity with CanonicalFS daemon client helpers.",
+  "license": "LicenseRef-Stinger-Royalty-Free-EULA-1.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/romanilyin/canonicalpath.git",
+    "directory": "packages/ts"
+  },
+  "homepage": "https://github.com/romanilyin/canonicalpath#readme",
+  "bugs": {
+    "url": "https://github.com/romanilyin/canonicalpath/issues"
+  },
+  "keywords": ["canonicalpath", "canonicalfs", "path", "filesystem", "path-traversal"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/canonicalpath/index.js",
+  "types": "./dist/canonicalpath/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/canonicalpath/index.d.ts",
+      "import": "./dist/canonicalpath/index.js",
+      "default": "./dist/canonicalpath/index.js"
+    },
+    "./canonicalpath": {
+      "types": "./dist/canonicalpath/index.d.ts",
+      "import": "./dist/canonicalpath/index.js",
+      "default": "./dist/canonicalpath/index.js"
+    },
+    "./canonicalfs": {
+      "types": "./dist/canonicalfs/index.d.ts",
+      "import": "./dist/canonicalfs/index.js",
+      "default": "./dist/canonicalfs/index.js"
+    },
+    "./unity-gateway": {
+      "types": "./dist/unity-gateway/index.d.ts",
+      "import": "./dist/unity-gateway/index.js",
+      "default": "./dist/unity-gateway/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE.md", "LICENSE.ru.md", "NOTICE.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "package:smoke": "node test/package-smoke.mjs",
+    "prepack": "node ../../scripts/sync-npm-package-notices.mjs copy",
+    "postpack": "node ../../scripts/sync-npm-package-notices.mjs clean",
+    "pack:dry-run": "npm pack --dry-run",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "format": "tsc --noEmit"
+  }
+}