@iwsdk/cli 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +12 -0
- package/dist/argv.d.ts +11 -0
- package/dist/argv.d.ts.map +1 -0
- package/dist/cli-results.d.ts +14 -0
- package/dist/cli-results.d.ts.map +1 -0
- package/dist/cli-types.d.ts +40 -0
- package/dist/cli-types.d.ts.map +1 -0
- package/dist/cli.d.ts +8 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +23514 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/adapter.d.ts +19 -0
- package/dist/commands/adapter.d.ts.map +1 -0
- package/dist/commands/dev.d.ts +14 -0
- package/dist/commands/dev.d.ts.map +1 -0
- package/dist/commands/mcp.d.ts +10 -0
- package/dist/commands/mcp.d.ts.map +1 -0
- package/dist/commands/reference.d.ts +12 -0
- package/dist/commands/reference.d.ts.map +1 -0
- package/dist/commands/runtime.d.ts +9 -0
- package/dist/commands/runtime.d.ts.map +1 -0
- package/dist/commands/status.d.ts +10 -0
- package/dist/commands/status.d.ts.map +1 -0
- package/dist/contract.js +874 -0
- package/dist/contract.js.map +1 -0
- package/dist/help.d.ts +11 -0
- package/dist/help.d.ts.map +1 -0
- package/dist/hzdb-telemetry.d.ts +8 -0
- package/dist/hzdb-telemetry.d.ts.map +1 -0
- package/dist/index.d.ts +12 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23504 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-adapters.d.ts +52 -0
- package/dist/mcp-adapters.d.ts.map +1 -0
- package/dist/mcp-stdio.d.ts +14 -0
- package/dist/mcp-stdio.d.ts.map +1 -0
- package/dist/reference-runtime.d.ts +12 -0
- package/dist/reference-runtime.d.ts.map +1 -0
- package/dist/runtime-contract.d.ts +116 -0
- package/dist/runtime-contract.d.ts.map +1 -0
- package/dist/runtime-state.d.ts +51 -0
- package/dist/runtime-state.d.ts.map +1 -0
- package/dist/runtime-transport.d.ts +36 -0
- package/dist/runtime-transport.d.ts.map +1 -0
- package/package.json +65 -0
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
import { type AiTool } from './runtime-contract.js';
|
|
8
|
+
interface StableMcpCommandEntry {
|
|
9
|
+
command: string;
|
|
10
|
+
args: string[];
|
|
11
|
+
}
|
|
12
|
+
type StableMcpEntryMap = Record<string, StableMcpCommandEntry>;
|
|
13
|
+
export interface ManagedMcpServerRegistry {
|
|
14
|
+
entries: StableMcpEntryMap;
|
|
15
|
+
managedNames: string[];
|
|
16
|
+
}
|
|
17
|
+
export interface SyncMcpAdaptersOptions {
|
|
18
|
+
workspaceRoot: string;
|
|
19
|
+
tools?: AiTool[];
|
|
20
|
+
command?: string;
|
|
21
|
+
args?: string[];
|
|
22
|
+
}
|
|
23
|
+
export interface PruneMcpAdaptersOptions {
|
|
24
|
+
workspaceRoot: string;
|
|
25
|
+
tools?: AiTool[];
|
|
26
|
+
weCreatedFile?: boolean;
|
|
27
|
+
}
|
|
28
|
+
export declare const DEFAULT_MCP_SERVER_NAME: string;
|
|
29
|
+
export declare const DEFAULT_MCP_SERVER_ARGS: readonly ["mcp", "stdio"];
|
|
30
|
+
export declare const OPTIONAL_MCP_SERVER_NAMES: readonly string[];
|
|
31
|
+
export declare const LEGACY_MCP_SERVER_NAMES: readonly string[];
|
|
32
|
+
export declare const LEGACY_MCP_ARG_TOKENS: readonly string[];
|
|
33
|
+
export declare const ALL_MANAGED_MCP_SERVER_NAMES: readonly string[];
|
|
34
|
+
export declare function hasManagedMcpServerReference(content: string, serverName: string): boolean;
|
|
35
|
+
export declare function hasManagedMcpArgToken(content: string, argToken: string): boolean;
|
|
36
|
+
export declare function getManagedMcpServerRegistry({ workspaceRoot, command, args, }?: {
|
|
37
|
+
workspaceRoot?: string;
|
|
38
|
+
command?: string;
|
|
39
|
+
args?: string[];
|
|
40
|
+
}): ManagedMcpServerRegistry;
|
|
41
|
+
export declare function mergeJsonConfig(filePath: string, serverEntries: Record<string, unknown>, jsonKey: string, managedKeys?: string[]): Promise<boolean>;
|
|
42
|
+
export declare function unmergeJsonConfig(filePath: string, serverKeys: string[], jsonKey: string, weCreatedFile: boolean): Promise<void>;
|
|
43
|
+
export declare function mergeTomlConfig(filePath: string, serverEntries: StableMcpEntryMap, managedKeys?: string[]): Promise<boolean>;
|
|
44
|
+
export declare function unmergeTomlConfig(filePath: string, weCreatedFile: boolean, serverKeys?: string[]): Promise<void>;
|
|
45
|
+
export declare function syncMcpAdapters({ workspaceRoot, tools, command, args, }: SyncMcpAdaptersOptions): Promise<{
|
|
46
|
+
workspaceRoot: string;
|
|
47
|
+
tools: AiTool[];
|
|
48
|
+
serverNames: string[];
|
|
49
|
+
}>;
|
|
50
|
+
export declare function pruneMcpAdapters({ workspaceRoot, tools, weCreatedFile, }: PruneMcpAdaptersOptions): Promise<void>;
|
|
51
|
+
export {};
|
|
52
|
+
//# sourceMappingURL=mcp-adapters.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-adapters.d.ts","sourceRoot":"","sources":["../src/mcp-adapters.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
import { type RuntimeSession } from './runtime-contract.js';
|
|
8
|
+
export interface StartRuntimeMcpStdioServerOptions {
|
|
9
|
+
serverName?: string;
|
|
10
|
+
version?: string;
|
|
11
|
+
resolveSession: () => Promise<RuntimeSession | null>;
|
|
12
|
+
}
|
|
13
|
+
export declare function startRuntimeMcpStdioServer({ serverName, version, resolveSession, }: StartRuntimeMcpStdioServerOptions): Promise<void>;
|
|
14
|
+
//# sourceMappingURL=mcp-stdio.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-stdio.d.ts","sourceRoot":"","sources":["../src/mcp-stdio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAW/B,MAAM,WAAW,iCAAiC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtD;AAuID,wBAAsB,0BAA0B,CAAC,EAC/C,UAAoB,EACpB,OAAiB,EACjB,cAAc,GACf,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJnD"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
import type { ResolvedCliIo } from './cli-types.js';
|
|
8
|
+
export declare function getReferencePackageRoot(workspaceRoot: string): string;
|
|
9
|
+
export declare function getReferenceEntrypoint(workspaceRoot: string): string;
|
|
10
|
+
export declare function hasReferenceInstalled(workspaceRoot: string): boolean;
|
|
11
|
+
export declare function resolveReferenceWorkspaceRoot(options: Record<string, unknown>, context: ResolvedCliIo): Promise<string>;
|
|
12
|
+
//# sourceMappingURL=reference-runtime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reference-runtime.d.ts","sourceRoot":"","sources":["../src/reference-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOrE;AAUD,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAQjB"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
export type AiTool = 'claude' | 'cursor' | 'copilot' | 'codex';
|
|
8
|
+
export type JsonSchema = {
|
|
9
|
+
type?: string;
|
|
10
|
+
description?: string;
|
|
11
|
+
enum?: string[];
|
|
12
|
+
oneOf?: JsonSchema[];
|
|
13
|
+
items?: JsonSchema;
|
|
14
|
+
properties?: Record<string, JsonSchema>;
|
|
15
|
+
required?: string[];
|
|
16
|
+
minimum?: number;
|
|
17
|
+
maximum?: number;
|
|
18
|
+
};
|
|
19
|
+
export interface McpConfigTarget {
|
|
20
|
+
file: string;
|
|
21
|
+
jsonKey: string | null;
|
|
22
|
+
format: 'json' | 'toml';
|
|
23
|
+
}
|
|
24
|
+
export interface McpToolDefinition {
|
|
25
|
+
name: string;
|
|
26
|
+
description: string;
|
|
27
|
+
inputSchema: JsonSchema;
|
|
28
|
+
}
|
|
29
|
+
export interface RuntimeOperationDefinition {
|
|
30
|
+
id: string;
|
|
31
|
+
domain: string;
|
|
32
|
+
action: string;
|
|
33
|
+
cliPath: [string, string] | string[];
|
|
34
|
+
mcpName: string;
|
|
35
|
+
wsMethod: string;
|
|
36
|
+
description: string;
|
|
37
|
+
inputSchema: JsonSchema;
|
|
38
|
+
}
|
|
39
|
+
export declare const IWSDK_PROJECT_STATE_DIR = ".iwsdk";
|
|
40
|
+
export declare const IWSDK_RUNTIME_STATE_DIR = ".iwsdk/runtime";
|
|
41
|
+
export declare const IWSDK_RUNTIME_LOGS_DIR = ".iwsdk/runtime/logs";
|
|
42
|
+
export declare const IWSDK_RUNTIME_SESSION_PATH = ".iwsdk/runtime/session.json";
|
|
43
|
+
export declare const IWSDK_RUNTIME_LAUNCH_PATH = ".iwsdk/runtime/launch.json";
|
|
44
|
+
export declare const IWSDK_RUNTIME_STATE_SCHEMA_VERSION = 2;
|
|
45
|
+
export declare const IWSDK_RUNTIME_BROWSER_READY_SCHEMA_VERSION = 2;
|
|
46
|
+
export declare const INTERNAL_BROWSER_PROBE_METHOD = "__iwsdk_browser_probe";
|
|
47
|
+
export type RuntimeIssueCause = 'browser_not_ready' | 'browser_not_launched' | 'browser_launch_failed' | 'connection_lost' | 'permission_denied' | 'browser_relaunched' | 'tab_throttled' | 'open_failed';
|
|
48
|
+
export interface RuntimeIssueInfo {
|
|
49
|
+
cause: RuntimeIssueCause;
|
|
50
|
+
message: string;
|
|
51
|
+
at: string;
|
|
52
|
+
}
|
|
53
|
+
export type RuntimeBrowserStatus = 'launching' | 'waiting_for_connection' | 'connected' | 'disconnected' | 'launch_failed';
|
|
54
|
+
export interface RuntimeBrowserState {
|
|
55
|
+
status: RuntimeBrowserStatus;
|
|
56
|
+
connected: boolean;
|
|
57
|
+
commandReady: boolean;
|
|
58
|
+
connectedClientCount: number;
|
|
59
|
+
lastTransitionAt: string;
|
|
60
|
+
lastBridgeConnectedAt?: string;
|
|
61
|
+
lastCommandReadyAt?: string;
|
|
62
|
+
lastError?: RuntimeIssueInfo;
|
|
63
|
+
}
|
|
64
|
+
export interface RuntimeBrowserProbeResult {
|
|
65
|
+
bridgeConnected: boolean;
|
|
66
|
+
commandReady: boolean;
|
|
67
|
+
waitedForBridgeMs: number;
|
|
68
|
+
browser: RuntimeBrowserState;
|
|
69
|
+
}
|
|
70
|
+
export interface RuntimeSession {
|
|
71
|
+
schemaVersion: number;
|
|
72
|
+
sessionId: string;
|
|
73
|
+
workspaceRoot: string;
|
|
74
|
+
pid: number;
|
|
75
|
+
port: number;
|
|
76
|
+
localUrl: string;
|
|
77
|
+
networkUrls: string[];
|
|
78
|
+
aiMode?: string;
|
|
79
|
+
browser?: RuntimeBrowserState;
|
|
80
|
+
registeredAt: string;
|
|
81
|
+
updatedAt: string;
|
|
82
|
+
}
|
|
83
|
+
export interface LaunchMetadata {
|
|
84
|
+
schemaVersion: number;
|
|
85
|
+
workspaceRoot: string;
|
|
86
|
+
pid: number;
|
|
87
|
+
command: string;
|
|
88
|
+
args: string[];
|
|
89
|
+
logPath: string | null;
|
|
90
|
+
scriptName: string;
|
|
91
|
+
port: number | null;
|
|
92
|
+
openBrowser: boolean;
|
|
93
|
+
createdAt: string;
|
|
94
|
+
}
|
|
95
|
+
export interface WorkspaceRuntimeState {
|
|
96
|
+
workspaceRoot: string;
|
|
97
|
+
running: boolean;
|
|
98
|
+
starting: boolean;
|
|
99
|
+
browserConnected: boolean;
|
|
100
|
+
browserCommandReady: boolean;
|
|
101
|
+
session: RuntimeSession | null;
|
|
102
|
+
launch: LaunchMetadata | null;
|
|
103
|
+
}
|
|
104
|
+
type RuntimeBrowserStatusSession = Pick<RuntimeSession, 'schemaVersion' | 'browser'>;
|
|
105
|
+
export declare function hasRuntimeBrowserCommandReadyContract(session: RuntimeBrowserStatusSession | null | undefined): boolean;
|
|
106
|
+
export declare function isRuntimeBrowserCommandReady(session: RuntimeBrowserStatusSession | null | undefined): boolean;
|
|
107
|
+
export declare const SUPPORTED_AI_TOOLS: AiTool[];
|
|
108
|
+
export declare const MCP_CONFIG_TARGETS: Record<AiTool, McpConfigTarget>;
|
|
109
|
+
export declare const RUNTIME_MCP_TOOLS: McpToolDefinition[];
|
|
110
|
+
export declare const RUNTIME_TOOL_TO_METHOD: Record<string, string>;
|
|
111
|
+
export declare const RUNTIME_CLI_PATHS: Record<string, string[]>;
|
|
112
|
+
export declare const RUNTIME_OPERATIONS: RuntimeOperationDefinition[];
|
|
113
|
+
export declare function getRuntimeOperationByToolName(toolName: string): RuntimeOperationDefinition | undefined;
|
|
114
|
+
export declare function getRuntimeOperationByCliPath(domain: string, action: string): RuntimeOperationDefinition | undefined;
|
|
115
|
+
export {};
|
|
116
|
+
//# sourceMappingURL=runtime-contract.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-contract.d.ts","sourceRoot":"","sources":["../src/runtime-contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
import { type LaunchMetadata, type RuntimeBrowserState, type RuntimeSession, type WorkspaceRuntimeState } from './runtime-contract.js';
|
|
8
|
+
export interface RegisterRuntimeSessionInput {
|
|
9
|
+
sessionId: string;
|
|
10
|
+
workspaceRoot: string;
|
|
11
|
+
pid: number;
|
|
12
|
+
port: number;
|
|
13
|
+
localUrl: string;
|
|
14
|
+
networkUrls?: string[];
|
|
15
|
+
aiMode?: string;
|
|
16
|
+
browser?: RuntimeBrowserState;
|
|
17
|
+
}
|
|
18
|
+
export interface SetLaunchMetadataInput {
|
|
19
|
+
workspaceRoot: string;
|
|
20
|
+
pid: number;
|
|
21
|
+
command: string;
|
|
22
|
+
args?: string[];
|
|
23
|
+
logPath?: string | null;
|
|
24
|
+
scriptName?: string;
|
|
25
|
+
port?: number | null;
|
|
26
|
+
openBrowser?: boolean;
|
|
27
|
+
}
|
|
28
|
+
export interface ResolveWorkspaceRootOptions {
|
|
29
|
+
cwd?: string;
|
|
30
|
+
workspace?: string;
|
|
31
|
+
requireRunning?: boolean;
|
|
32
|
+
}
|
|
33
|
+
export declare function normalizeWorkspaceRoot(workspaceRoot: string): string;
|
|
34
|
+
export declare function getRuntimeSessionFilePath(workspaceRoot: string): string;
|
|
35
|
+
export declare function getRuntimeLaunchFilePath(workspaceRoot: string): string;
|
|
36
|
+
export declare function getRuntimeLogsDir(workspaceRoot: string): string;
|
|
37
|
+
export declare function ensureRuntimeLogsDir(workspaceRoot: string): Promise<string>;
|
|
38
|
+
export declare function isProcessAlive(pid: number): boolean;
|
|
39
|
+
export declare function isIwsdkAppRoot(dirPath: string): boolean;
|
|
40
|
+
export declare function findNearestIwsdkAppRoot(startDir?: string): string | null;
|
|
41
|
+
export declare function registerRuntimeSession(input: RegisterRuntimeSessionInput): Promise<RuntimeSession>;
|
|
42
|
+
export declare function setRuntimeSessionBrowserState(workspaceRoot: string, browser: RuntimeBrowserState): Promise<RuntimeSession | null>;
|
|
43
|
+
export declare function unregisterRuntimeSession(workspaceRoot: string): Promise<void>;
|
|
44
|
+
export declare function getRuntimeSession(workspaceRoot: string): Promise<RuntimeSession | null>;
|
|
45
|
+
export declare function setLaunchMetadata(input: SetLaunchMetadataInput): Promise<LaunchMetadata>;
|
|
46
|
+
export declare function clearLaunchMetadata(workspaceRoot: string): Promise<void>;
|
|
47
|
+
export declare function getLaunchMetadata(workspaceRoot: string): Promise<LaunchMetadata | null>;
|
|
48
|
+
export declare function getWorkspaceRuntimeState(workspaceRoot: string): Promise<WorkspaceRuntimeState>;
|
|
49
|
+
export declare function formatMissingRuntimeMessage(workspaceRoot: string): string;
|
|
50
|
+
export declare function resolveWorkspaceRoot({ cwd, workspace, requireRunning, }?: ResolveWorkspaceRootOptions): Promise<string>;
|
|
51
|
+
//# sourceMappingURL=runtime-state.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
import { type RuntimeBrowserState, type RuntimeIssueCause, type RuntimeSession } from './runtime-contract.js';
|
|
8
|
+
type RuntimeCommandError = {
|
|
9
|
+
message?: string;
|
|
10
|
+
cause?: RuntimeIssueCause;
|
|
11
|
+
};
|
|
12
|
+
export interface RuntimeCommandResponse {
|
|
13
|
+
id?: string;
|
|
14
|
+
result?: unknown;
|
|
15
|
+
_tabId?: string;
|
|
16
|
+
_tabGeneration?: number;
|
|
17
|
+
error?: RuntimeCommandError;
|
|
18
|
+
}
|
|
19
|
+
export interface SendRuntimeCommandOptions {
|
|
20
|
+
port: number;
|
|
21
|
+
method: string;
|
|
22
|
+
params?: unknown;
|
|
23
|
+
timeoutMs?: number;
|
|
24
|
+
runtimeSession?: RuntimeSession | null;
|
|
25
|
+
}
|
|
26
|
+
export declare class RuntimeCommandExecutionError extends Error {
|
|
27
|
+
issueCause?: RuntimeIssueCause;
|
|
28
|
+
browser?: RuntimeBrowserState;
|
|
29
|
+
constructor(message: string, options?: {
|
|
30
|
+
issueCause?: RuntimeIssueCause;
|
|
31
|
+
browser?: RuntimeBrowserState;
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
export declare function sendRuntimeCommand({ port, method, params, timeoutMs, runtimeSession, }: SendRuntimeCommandOptions): Promise<RuntimeCommandResponse>;
|
|
35
|
+
export {};
|
|
36
|
+
//# sourceMappingURL=runtime-transport.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-transport.d.ts","sourceRoot":"","sources":["../src/runtime-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAI/B,KAAK,mBAAmB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAG3E,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,OAAO,CAAC,EAAE,mBAAmB,CAAC;KAC1B;CAOT;AAsVD,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,MAAM,EACN,MAAM,EACN,SAAiB,EACjB,cAAc,GACf,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqD7D"}
|
package/package.json
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@iwsdk/cli",
|
|
3
|
+
"version": "0.3.2",
|
|
4
|
+
"description": "Runtime-first CLI for IWSDK dev servers, adapters, and MCP access",
|
|
5
|
+
"private": false,
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"iwsdk": "dist/cli.js"
|
|
9
|
+
},
|
|
10
|
+
"main": "dist/index.js",
|
|
11
|
+
"types": "dist/index.d.ts",
|
|
12
|
+
"exports": {
|
|
13
|
+
".": {
|
|
14
|
+
"types": "./dist/index.d.ts",
|
|
15
|
+
"import": "./dist/index.js"
|
|
16
|
+
},
|
|
17
|
+
"./contract": {
|
|
18
|
+
"types": "./dist/runtime-contract.d.ts",
|
|
19
|
+
"import": "./dist/contract.js"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"typesVersions": {
|
|
23
|
+
"*": {
|
|
24
|
+
"contract": [
|
|
25
|
+
"dist/runtime-contract.d.ts"
|
|
26
|
+
]
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
"files": [
|
|
30
|
+
"dist",
|
|
31
|
+
"README.md"
|
|
32
|
+
],
|
|
33
|
+
"keywords": [
|
|
34
|
+
"iwsdk",
|
|
35
|
+
"cli",
|
|
36
|
+
"mcp",
|
|
37
|
+
"runtime",
|
|
38
|
+
"webxr"
|
|
39
|
+
],
|
|
40
|
+
"repository": {
|
|
41
|
+
"type": "git",
|
|
42
|
+
"url": "git+https://github.com/facebook/immersive-web-sdk.git"
|
|
43
|
+
},
|
|
44
|
+
"author": "Felix Zhang <fe1ix@meta.com>",
|
|
45
|
+
"license": "MIT",
|
|
46
|
+
"bugs": {
|
|
47
|
+
"url": "https://github.com/facebook/immersive-web-sdk/issues"
|
|
48
|
+
},
|
|
49
|
+
"homepage": "https://github.com/facebook/immersive-web-sdk#readme",
|
|
50
|
+
"engines": {
|
|
51
|
+
"node": ">=20.19.0"
|
|
52
|
+
},
|
|
53
|
+
"devDependencies": {
|
|
54
|
+
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
55
|
+
"@types/ws": "^8.5.13",
|
|
56
|
+
"vitest": "^4.0.0",
|
|
57
|
+
"ws": "^8.18.0"
|
|
58
|
+
},
|
|
59
|
+
"scripts": {
|
|
60
|
+
"build": "tsc -p tsconfig.json --emitDeclarationOnly && rollup -c",
|
|
61
|
+
"clean": "rm -rf dist",
|
|
62
|
+
"test": "pnpm build && vitest run",
|
|
63
|
+
"test:watch": "vitest"
|
|
64
|
+
}
|
|
65
|
+
}
|