@vgai/live 0.4.1-canary.20260715.0 → 0.4.1

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/live",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.4.1-canary.20260715.0",
+  "version": "0.4.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,9 +30,9 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@vgai/editor-sdk": "0.4.1-canary.20260715.0",
-    "@vgai/probe": "0.4.1-canary.20260715.0",
-    "@vgai/sdk": "0.4.1-canary.20260715.0"
+    "@vgai/editor-sdk": "0.4.1",
+    "@vgai/probe": "0.4.1",
+    "@vgai/sdk": "0.4.1"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.58.2 <2"

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * `@vgai/live` — `{ editor, game, page }` over the session wire
+ * `@vgai/live` — `{ editor, game, page, tools }` over the session wire
  * (docs/SHARED-SESSION-SPEC.md, Wave 2). Editor control consolidates HERE
  * from the ~19 `vgai` CLI verbs: a plain node/tsx script gets
  * `import { editor, game, page } from '@vgai/live'` instead of shelling out
@@ -45,6 +45,7 @@ import { createGameClient } from './game.js';
 import { lazyChainProxy } from './lazy-proxy.js';
 import { type ResolvedSession, resolveSession, type SessionResolutionDeps } from './session.js';
 import { createLazySession } from './singleton.js';
+import { LiveTools } from './tools.js';
 
 export type { EditorClient } from '@vgai/editor-sdk';
 export type { GameClient } from '@vgai/probe';
@@ -59,6 +60,7 @@ export type {
 export { findProjectRootFrom, resolveSession } from './session.js';
 export type { LazySession } from './singleton.js';
 export { createLazySession } from './singleton.js';
+export { LiveTools } from './tools.js';
 
 /** A `game.page(step)`-shaped call — see this module's doc comment for the closure-capture limitation. */
 export type PageStep = GameClient['page'];
@@ -68,6 +70,8 @@ export interface LiveSession {
   game: GameClient;
   /** `GameClient.page` bound to `game` — see this module's own doc comment for the wire limitation. */
   page: PageStep;
+  /** Registered project callables: enumerate, inspect, and invoke. */
+  tools: LiveTools;
   /** The resolved session this is bound to — useful for logging/debugging which port/project a script attached to. */
   session: ResolvedSession;
 }
@@ -87,7 +91,8 @@ export async function connect(
   const editor = new LiveEditor(client, resolved.projectRoot);
   const game = createGameClient(resolved.port);
   const page: PageStep = (step) => game.page(step);
-  return { editor, game, page, session: resolved };
+  const tools = new LiveTools(client);
+  return { editor, game, page, tools, session: resolved };
 }
 
 // ---------------------------------------------------------------------------
@@ -113,3 +118,6 @@ export const game: GameClient = lazyChainProxy<GameClient>(() =>
 export const page: PageStep = lazyChainProxy<PageStep>(() =>
   lazySession.ensure().then((s) => s.page),
 );
+export const tools: LiveTools = lazyChainProxy<LiveTools>(() =>
+  lazySession.ensure().then((s) => s.tools),
+);

package/src/tools.ts

@@ -0,0 +1,32 @@
+/** Registered project tools over the current shared editor session. */
+
+import type {
+  EditorClient,
+  ProjectToolCatalog,
+  ProjectToolCatalogEntry,
+  ProjectToolOutcome,
+} from '@vgai/editor-sdk';
+
+export class LiveTools {
+  constructor(private readonly client: EditorClient) {}
+
+  /** Enumerate the exact `package.json#vgai.tools` catalog without executing it. */
+  async list(): Promise<ProjectToolCatalog> {
+    return this.client.listProjectTools();
+  }
+
+  /** Return one tool's discoverable metadata, or `null` when it is not registered. */
+  async describe(name: string): Promise<ProjectToolCatalogEntry | null> {
+    const catalog = await this.list();
+    return catalog.tools.find((tool) => tool.name === name) ?? null;
+  }
+
+  /** Invoke the same validated callable used by the editor and CLI. */
+  async call(
+    name: string,
+    input: unknown = {},
+    options: { confirm?: boolean } = {},
+  ): Promise<ProjectToolOutcome> {
+    return this.client.runProjectTool(name, input, options);
+  }
+}