@coreframe/dev-contracts 0.1.7 → 0.1.9

package/dist/flutter-devtools.d.ts

@@ -0,0 +1,57 @@
+//#region src/flutter-devtools.d.ts
+/** Wire-protocol version shared by the page, Vite broker, and native Flutter client. */
+declare const flutterDevToolsProtocolVersion = 1;
+/** Vite custom-event names for pairing Flutter development surfaces with their page runtime. */
+declare const flutterDevToolsEvents: {
+  readonly nativeConnect: "coreframe:flutter-devtools:native-connect";
+  readonly pageConnect: "coreframe:flutter-devtools:page-connect";
+  readonly pageDisconnect: "coreframe:flutter-devtools:page-disconnect";
+  readonly ready: "coreframe:flutter-devtools:ready";
+  readonly stateLauncherConnection: "coreframe:flutter-devtools:state-launcher-connection";
+  readonly stateLauncherRequest: "coreframe:flutter-devtools:state-launcher-request";
+  readonly stateLauncherResult: "coreframe:flutter-devtools:state-launcher-result";
+  readonly stateLauncherState: "coreframe:flutter-devtools:state-launcher-state";
+};
+/** Identifies one page-runtime epoch inside a Flutter shell session. */
+type FlutterDevToolsIdentity = {
+  applicationScopeId: string;
+  rootWebRuntimeId: string;
+  shellSessionId: string;
+};
+/** Identifies one WebView runtime without coupling it to application auth. */
+type FlutterDevToolsLauncherIdentity = Pick<FlutterDevToolsIdentity, "rootWebRuntimeId" | "shellSessionId"> & {
+  /** Kept optional so older scoped launcher messages remain source-compatible. */applicationScopeId?: string;
+};
+/** Registers an independent native client with the Vite broker. */
+type FlutterDevToolsNativeConnect = {
+  protocolVersion: typeof flutterDevToolsProtocolVersion;
+  shellSessionId: string;
+};
+/** Registers the current page-runtime epoch with the Vite broker. */
+type FlutterDevToolsPageConnect = FlutterDevToolsIdentity & {
+  protocolVersion: typeof flutterDevToolsProtocolVersion;
+};
+/** Reports server-owned capabilities to a registered native client. */
+type FlutterDevToolsReady = {
+  managedDev: boolean;
+  protocolVersion: typeof flutterDevToolsProtocolVersion;
+};
+/** Reports whether the native launcher has a current page-runtime peer. */
+type FlutterDevToolsStateLauncherConnection = {
+  connected: boolean;
+  identity?: FlutterDevToolsLauncherIdentity;
+};
+/** Routes a launcher request from the native client to its paired page. */
+type FlutterDevToolsStateLauncherRequest<Request = unknown> = FlutterDevToolsLauncherIdentity & {
+  request: Request;
+};
+/** Routes a launcher result from the paired page to its native client. */
+type FlutterDevToolsStateLauncherResult<Result = unknown> = FlutterDevToolsLauncherIdentity & {
+  result: Result;
+};
+/** Publishes page-owned launcher state to the paired native client. */
+type FlutterDevToolsStateLauncherState<State = unknown> = FlutterDevToolsLauncherIdentity & {
+  state: State;
+};
+//#endregion
+export { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion };

package/dist/flutter-devtools.js

@@ -0,0 +1 @@
+const e=1,t={nativeConnect:`coreframe:flutter-devtools:native-connect`,pageConnect:`coreframe:flutter-devtools:page-connect`,pageDisconnect:`coreframe:flutter-devtools:page-disconnect`,ready:`coreframe:flutter-devtools:ready`,stateLauncherConnection:`coreframe:flutter-devtools:state-launcher-connection`,stateLauncherRequest:`coreframe:flutter-devtools:state-launcher-request`,stateLauncherResult:`coreframe:flutter-devtools:state-launcher-result`,stateLauncherState:`coreframe:flutter-devtools:state-launcher-state`};export{t as flutterDevToolsEvents,e as flutterDevToolsProtocolVersion};

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { CodexTaskStartRequest, CodexTaskStartResponse, codexTaskEnv, codexTaskEvents } from "./codex-task.js";
 import { devJobsEnv, devJobsPath, devJobsTokenHeader } from "./dev-jobs.js";
 import { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, developmentControlsEvents } from "./development-controls.js";
-import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv } from "./managed-dev.js";
-export { CodexTaskStartRequest, CodexTaskStartResponse, DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, codexTaskEnv, codexTaskEvents, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv };
+import { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion } from "./flutter-devtools.js";
+import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix } from "./managed-dev.js";
+export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, flutterDevToolsEvents, flutterDevToolsProtocolVersion, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };

package/dist/index.js

@@ -1 +1 @@
-import{codexTaskEnv as e,codexTaskEvents as t}from"./codex-task.js";import{devJobsEnv as n,devJobsPath as r,devJobsTokenHeader as i}from"./dev-jobs.js";import{developmentControlsEvents as a}from"./development-controls.js";import{managedDevEnv as o,managedDevEvents as s,managedDevFlutterRestartFileEnv as c}from"./managed-dev.js";export{e as codexTaskEnv,t as codexTaskEvents,n as devJobsEnv,r as devJobsPath,i as devJobsTokenHeader,a as developmentControlsEvents,o as managedDevEnv,s as managedDevEvents,c as managedDevFlutterRestartFileEnv};
+import{devJobsEnv as e,devJobsPath as t,devJobsTokenHeader as n}from"./dev-jobs.js";import{developmentControlsEvents as r}from"./development-controls.js";import{flutterDevToolsEvents as i,flutterDevToolsProtocolVersion as a}from"./flutter-devtools.js";import{managedDevEnv as o,managedDevEvents as s,managedDevFlutterRestartFileEnv as c,managedDevSupervisorRecoveryErrorPrefix as l,managedDevSupervisorRecoveryPrefix as u}from"./managed-dev.js";export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,i as flutterDevToolsEvents,a as flutterDevToolsProtocolVersion,o as managedDevEnv,s as managedDevEvents,c as managedDevFlutterRestartFileEnv,l as managedDevSupervisorRecoveryErrorPrefix,u as managedDevSupervisorRecoveryPrefix};

package/dist/managed-dev.d.ts

@@ -8,6 +8,8 @@ declare const managedDevEvents: {
   readonly status: "coreframe:managed-dev:status";
   readonly statusRequest: "coreframe:managed-dev:status-request";
 };
+declare const managedDevSupervisorRecoveryPrefix = "Managed development supervisor ";
+declare const managedDevSupervisorRecoveryErrorPrefix = "Managed development supervisor recovery failed after ";
 type ManagedDevCommit = {
   commit: string;
   shortCommit: string;
@@ -90,6 +92,10 @@ type ManagedDevAction = {
 } | {
   type: "retry-install";
 };
+/** An action handled by the Vite integration while a shared supervisor recovers. */
+type ManagedDevRecoveryAction = {
+  type: "retry-supervisor";
+};
 type ManagedDevActionResult = {
   status: ManagedDevStatus;
 };
@@ -125,7 +131,7 @@ type ManagedDevCodexEvent = {
   phase: "error";
 };
 type ManagedDevActionRequest = {
-  action: ManagedDevAction;
+  action: ManagedDevAction | ManagedDevRecoveryAction;
   requestId: string;
 };
 type ManagedDevActionResponse = Partial<ManagedDevActionResult> & {
@@ -139,4 +145,4 @@ type ManagedDevStatusResponse = {
   status: ManagedDevStatus;
 };
 //#endregion
-export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv };
+export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };

package/dist/managed-dev.js

@@ -1 +1 @@
-const e=`COREFRAME_MANAGED_DEV`,t=`COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE`,n={action:`coreframe:managed-dev:action`,actionResult:`coreframe:managed-dev:action-result`,codex:`coreframe:managed-dev:codex`,status:`coreframe:managed-dev:status`,statusRequest:`coreframe:managed-dev:status-request`};export{e as managedDevEnv,n as managedDevEvents,t as managedDevFlutterRestartFileEnv};
+const e=`COREFRAME_MANAGED_DEV`,t=`COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE`,n={action:`coreframe:managed-dev:action`,actionResult:`coreframe:managed-dev:action-result`,codex:`coreframe:managed-dev:codex`,status:`coreframe:managed-dev:status`,statusRequest:`coreframe:managed-dev:status-request`},r=`Managed development supervisor `,i=`${r}recovery failed after `;export{e as managedDevEnv,n as managedDevEvents,t as managedDevFlutterRestartFileEnv,i as managedDevSupervisorRecoveryErrorPrefix,r as managedDevSupervisorRecoveryPrefix};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreframe/dev-contracts",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Shared contracts for Coreframe managed development workflows",
   "repository": {
     "type": "git",
@@ -16,10 +16,6 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./codex-task": {
-      "types": "./dist/codex-task.d.ts",
-      "default": "./dist/codex-task.js"
-    },
     "./dev-jobs": {
       "types": "./dist/dev-jobs.d.ts",
       "default": "./dist/dev-jobs.js"
@@ -28,6 +24,10 @@
       "types": "./dist/development-controls.d.ts",
       "default": "./dist/development-controls.js"
     },
+    "./flutter-devtools": {
+      "types": "./dist/flutter-devtools.d.ts",
+      "default": "./dist/flutter-devtools.js"
+    },
     "./managed-dev": {
       "types": "./dist/managed-dev.d.ts",
       "default": "./dist/managed-dev.js"

package/dist/codex-task.d.ts

@@ -1,21 +0,0 @@
-//#region src/codex-task.d.ts
-declare const codexTaskEnv = "COREFRAME_CODEX_TASKS";
-declare const codexTaskEvents: {
-  readonly result: "coreframe:codex-task:result";
-  readonly start: "coreframe:codex-task:start";
-};
-type CodexTaskStartRequest = {
-  openInBackground?: boolean;
-  prompt: string;
-  requestId: string;
-};
-type CodexTaskStartResponse = {
-  error?: string;
-  openedInCodex?: boolean;
-  requestId: string;
-  threadId?: string;
-  url?: string;
-  warning?: string;
-};
-//#endregion
-export { CodexTaskStartRequest, CodexTaskStartResponse, codexTaskEnv, codexTaskEvents };

package/dist/codex-task.js

@@ -1 +0,0 @@
-const e=`COREFRAME_CODEX_TASKS`,t={result:`coreframe:codex-task:result`,start:`coreframe:codex-task:start`};export{e as codexTaskEnv,t as codexTaskEvents};