@coreframe/dev-contracts 0.1.10-next.1 → 3.0.0-beta.1

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.
@@ -2,7 +2,5 @@
2
2
  declare const devJobsEnv = "COREFRAME_DEV_JOBS_TOKEN";
3
3
  declare const devJobsPath = "/cdn-cgi/coreframe/dev/jobs";
4
4
  declare const devJobsTokenHeader = "x-coreframe-dev-jobs-token";
5
- /** Non-secret identity shared by jobs and the managed development session descriptor. */
6
- declare const devSessionIdEnv = "COREFRAME_DEV_SESSION_ID";
7
5
  //#endregion
8
- export { devJobsEnv, devJobsPath, devJobsTokenHeader, devSessionIdEnv };
6
+ export { devJobsEnv, devJobsPath, devJobsTokenHeader };
package/dist/dev-jobs.js CHANGED
@@ -1 +1 @@
1
- const e=`COREFRAME_DEV_JOBS_TOKEN`,t=`/cdn-cgi/coreframe/dev/jobs`,n=`x-coreframe-dev-jobs-token`,r=`COREFRAME_DEV_SESSION_ID`;export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as devSessionIdEnv};
1
+ const e=`COREFRAME_DEV_JOBS_TOKEN`,t=`/cdn-cgi/coreframe/dev/jobs`,n=`x-coreframe-dev-jobs-token`;export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader};
@@ -6,7 +6,7 @@ declare const developmentControlsEvents: {
6
6
  type DevelopmentControlAction = {
7
7
  type: "restart-vite";
8
8
  } | {
9
- type: "restart-flutter";
9
+ type: "restart-native";
10
10
  };
11
11
  type DevelopmentControlActionRequest = {
12
12
  action: DevelopmentControlAction;
package/dist/index.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import { devJobsEnv, devJobsPath, devJobsTokenHeader, devSessionIdEnv } from "./dev-jobs.js";
1
+ import { devJobsEnv, devJobsPath, devJobsTokenHeader } from "./dev-jobs.js";
2
2
  import { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, developmentControlsEvents } from "./development-controls.js";
3
- import { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion } from "./flutter-devtools.js";
4
- 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";
5
- 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, devSessionIdEnv, developmentControlsEvents, flutterDevToolsEvents, flutterDevToolsProtocolVersion, managedDevEnv, managedDevEvents, managedDevFlutterRestartFileEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
3
+ import { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevNativeRestartFileEnv, managedDevNativeRestartRootsEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix } from "./managed-dev.js";
4
+ export { DevelopmentControlAction, DevelopmentControlActionRequest, DevelopmentControlActionResponse, ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, devJobsEnv, devJobsPath, devJobsTokenHeader, developmentControlsEvents, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevNativeRestartFileEnv, managedDevNativeRestartRootsEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{devJobsEnv as e,devJobsPath as t,devJobsTokenHeader as n,devSessionIdEnv as r}from"./dev-jobs.js";import{developmentControlsEvents as i}from"./development-controls.js";import{flutterDevToolsEvents as a,flutterDevToolsProtocolVersion as o}from"./flutter-devtools.js";import{managedDevEnv as s,managedDevEvents as c,managedDevFlutterRestartFileEnv as l,managedDevSupervisorRecoveryErrorPrefix as u,managedDevSupervisorRecoveryPrefix as d}from"./managed-dev.js";export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as devSessionIdEnv,i as developmentControlsEvents,a as flutterDevToolsEvents,o as flutterDevToolsProtocolVersion,s as managedDevEnv,c as managedDevEvents,l as managedDevFlutterRestartFileEnv,u as managedDevSupervisorRecoveryErrorPrefix,d as managedDevSupervisorRecoveryPrefix};
1
+ import{devJobsEnv as e,devJobsPath as t,devJobsTokenHeader as n}from"./dev-jobs.js";import{developmentControlsEvents as r}from"./development-controls.js";import{managedDevCodexEfforts as i,managedDevCodexModels as a,managedDevEnv as o,managedDevEvents as s,managedDevNativeRestartFileEnv as c,managedDevNativeRestartRootsEnv as l,managedDevSupervisorRecoveryErrorPrefix as u,managedDevSupervisorRecoveryPrefix as d}from"./managed-dev.js";export{e as devJobsEnv,t as devJobsPath,n as devJobsTokenHeader,r as developmentControlsEvents,i as managedDevCodexEfforts,a as managedDevCodexModels,o as managedDevEnv,s as managedDevEvents,c as managedDevNativeRestartFileEnv,l as managedDevNativeRestartRootsEnv,u as managedDevSupervisorRecoveryErrorPrefix,d as managedDevSupervisorRecoveryPrefix};
@@ -1,6 +1,7 @@
1
1
  //#region src/managed-dev.d.ts
2
2
  declare const managedDevEnv = "COREFRAME_MANAGED_DEV";
3
- declare const managedDevFlutterRestartFileEnv = "COREFRAME_MANAGED_DEV_FLUTTER_RESTART_FILE";
3
+ declare const managedDevNativeRestartFileEnv = "COREFRAME_MANAGED_DEV_NATIVE_RESTART_FILE";
4
+ declare const managedDevNativeRestartRootsEnv = "COREFRAME_MANAGED_DEV_NATIVE_RESTART_ROOTS";
4
5
  declare const managedDevEvents: {
5
6
  readonly action: "coreframe:managed-dev:action";
6
7
  readonly actionResult: "coreframe:managed-dev:action-result";
@@ -42,18 +43,26 @@ type ManagedDevSetupFailure = {
42
43
  commit: string;
43
44
  message: string;
44
45
  output: string;
45
- flutterRestartRequired?: boolean;
46
+ nativeRestartRequired?: boolean;
46
47
  restartRequired: boolean;
47
48
  stage: "codegen" | "dependencies" | "migration";
48
49
  };
50
+ type ManagedDevPendingRebase = {
51
+ /** Local commits replayed cleanly before the first conflict. */applied: number; /** Local commits still waiting to be replayed, starting with the conflicted one. */
52
+ commits: ManagedDevCommit[]; /** Conflicted paths at the stop point. */
53
+ files: string[];
54
+ target: ManagedDevTarget;
55
+ };
49
56
  type ManagedDevStatus = {
50
57
  busy?: string;
51
58
  checks?: ManagedDevChecks;
52
59
  codexCompletion?: ManagedDevCodexCompletion;
60
+ codexOptions?: ManagedDevCodexOptions;
53
61
  currentCommit?: string;
54
62
  draft?: ManagedDevDraft;
55
63
  message?: string;
56
64
  mode: "error" | "managed" | "unmanaged" | "waiting";
65
+ pendingRebase?: ManagedDevPendingRebase;
57
66
  proposal?: string;
58
67
  setupFailure?: ManagedDevSetupFailure;
59
68
  target?: ManagedDevTarget;
@@ -62,15 +71,21 @@ type ManagedDevStatus = {
62
71
  type ManagedDevAction = {
63
72
  id: string;
64
73
  type: "acknowledge-codex";
74
+ } | {
75
+ type: "cancel-codex";
65
76
  } | {
66
77
  failureId: string;
67
78
  type: "dismiss-check";
68
79
  } | {
69
80
  type: "apply";
81
+ codex?: ManagedDevCodexOptions;
70
82
  fingerprint?: string;
71
83
  message?: string;
72
84
  target: string;
73
85
  untracked?: string[];
86
+ } | {
87
+ codex: ManagedDevCodexOptions;
88
+ type: "configure-codex";
74
89
  } | {
75
90
  type: "commit";
76
91
  fingerprint: string;
@@ -82,11 +97,17 @@ type ManagedDevAction = {
82
97
  untracked: string[];
83
98
  } | {
84
99
  type: "prepare";
100
+ codex?: ManagedDevCodexOptions;
85
101
  target: string;
102
+ } | {
103
+ type: "decline-rebase";
86
104
  } | {
87
105
  type: "reject";
88
106
  } | {
89
107
  type: "reset-database";
108
+ } | {
109
+ codex?: ManagedDevCodexOptions;
110
+ type: "resolve-rebase";
90
111
  } | {
91
112
  type: "retry-codegen";
92
113
  } | {
@@ -105,6 +126,15 @@ type ManagedDevCodexMessage = {
105
126
  text: string;
106
127
  };
107
128
  type ManagedDevRebasedCommit = ManagedDevCommit;
129
+ declare const managedDevCodexModels: readonly ["gpt-6.1-sol", "gpt-6-luna"];
130
+ declare const managedDevCodexEfforts: readonly ["low", "medium", "high", "xhigh", "max"];
131
+ type ManagedDevCodexModel = (typeof managedDevCodexModels)[number];
132
+ type ManagedDevCodexEffort = (typeof managedDevCodexEfforts)[number];
133
+ /** Optional Codex model and reasoning-effort overrides for conflict resolution. */
134
+ type ManagedDevCodexOptions = {
135
+ effort?: ManagedDevCodexEffort;
136
+ model?: ManagedDevCodexModel;
137
+ };
108
138
  type ManagedDevCodexCompletion = {
109
139
  commits?: ManagedDevRebasedCommit[];
110
140
  finalMessage: string;
@@ -145,4 +175,4 @@ type ManagedDevStatusResponse = {
145
175
  status: ManagedDevStatus;
146
176
  };
147
177
  //#endregion
148
- 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 };
178
+ export { ManagedDevAction, ManagedDevActionRequest, ManagedDevActionResponse, ManagedDevActionResult, ManagedDevCheck, ManagedDevCheckTrigger, ManagedDevChecks, ManagedDevCodexCompletion, ManagedDevCodexEffort, ManagedDevCodexEvent, ManagedDevCodexMessage, ManagedDevCodexModel, ManagedDevCodexOptions, ManagedDevCodexResponse, ManagedDevCommit, ManagedDevDraft, ManagedDevPendingRebase, ManagedDevRebasedCommit, ManagedDevRecoveryAction, ManagedDevSetupFailure, ManagedDevStatus, ManagedDevStatusResponse, ManagedDevTarget, managedDevCodexEfforts, managedDevCodexModels, managedDevEnv, managedDevEvents, managedDevNativeRestartFileEnv, managedDevNativeRestartRootsEnv, managedDevSupervisorRecoveryErrorPrefix, managedDevSupervisorRecoveryPrefix };
@@ -1 +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`},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};
1
+ const e=`COREFRAME_MANAGED_DEV`,t=`COREFRAME_MANAGED_DEV_NATIVE_RESTART_FILE`,n=`COREFRAME_MANAGED_DEV_NATIVE_RESTART_ROOTS`,r={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`},i=`Managed development supervisor `,a=`${i}recovery failed after `,o=[`gpt-6.1-sol`,`gpt-6-luna`],s=[`low`,`medium`,`high`,`xhigh`,`max`];export{s as managedDevCodexEfforts,o as managedDevCodexModels,e as managedDevEnv,r as managedDevEvents,t as managedDevNativeRestartFileEnv,n as managedDevNativeRestartRootsEnv,a as managedDevSupervisorRecoveryErrorPrefix,i as managedDevSupervisorRecoveryPrefix};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@coreframe/dev-contracts",
3
- "version": "0.1.10-next.1",
3
+ "version": "3.0.0-beta.1",
4
4
  "description": "Shared contracts for Coreframe managed development workflows",
5
5
  "repository": {
6
6
  "type": "git",
@@ -24,10 +24,6 @@
24
24
  "types": "./dist/development-controls.d.ts",
25
25
  "default": "./dist/development-controls.js"
26
26
  },
27
- "./flutter-devtools": {
28
- "types": "./dist/flutter-devtools.d.ts",
29
- "default": "./dist/flutter-devtools.js"
30
- },
31
27
  "./managed-dev": {
32
28
  "types": "./dist/managed-dev.d.ts",
33
29
  "default": "./dist/managed-dev.js"
@@ -1,57 +0,0 @@
1
- //#region src/flutter-devtools.d.ts
2
- /** Wire-protocol version shared by the page, Vite broker, and native Flutter client. */
3
- declare const flutterDevToolsProtocolVersion = 1;
4
- /** Vite custom-event names for pairing Flutter development surfaces with their page runtime. */
5
- declare const flutterDevToolsEvents: {
6
- readonly nativeConnect: "coreframe:flutter-devtools:native-connect";
7
- readonly pageConnect: "coreframe:flutter-devtools:page-connect";
8
- readonly pageDisconnect: "coreframe:flutter-devtools:page-disconnect";
9
- readonly ready: "coreframe:flutter-devtools:ready";
10
- readonly stateLauncherConnection: "coreframe:flutter-devtools:state-launcher-connection";
11
- readonly stateLauncherRequest: "coreframe:flutter-devtools:state-launcher-request";
12
- readonly stateLauncherResult: "coreframe:flutter-devtools:state-launcher-result";
13
- readonly stateLauncherState: "coreframe:flutter-devtools:state-launcher-state";
14
- };
15
- /** Identifies one page-runtime epoch inside a Flutter shell session. */
16
- type FlutterDevToolsIdentity = {
17
- applicationScopeId: string;
18
- rootWebRuntimeId: string;
19
- shellSessionId: string;
20
- };
21
- /** Identifies one WebView runtime without coupling it to application auth. */
22
- type FlutterDevToolsLauncherIdentity = Pick<FlutterDevToolsIdentity, "rootWebRuntimeId" | "shellSessionId"> & {
23
- /** Kept optional so older scoped launcher messages remain source-compatible. */applicationScopeId?: string;
24
- };
25
- /** Registers an independent native client with the Vite broker. */
26
- type FlutterDevToolsNativeConnect = {
27
- protocolVersion: typeof flutterDevToolsProtocolVersion;
28
- shellSessionId: string;
29
- };
30
- /** Registers the current page-runtime epoch with the Vite broker. */
31
- type FlutterDevToolsPageConnect = FlutterDevToolsIdentity & {
32
- protocolVersion: typeof flutterDevToolsProtocolVersion;
33
- };
34
- /** Reports server-owned capabilities to a registered native client. */
35
- type FlutterDevToolsReady = {
36
- managedDev: boolean;
37
- protocolVersion: typeof flutterDevToolsProtocolVersion;
38
- };
39
- /** Reports whether the native launcher has a current page-runtime peer. */
40
- type FlutterDevToolsStateLauncherConnection = {
41
- connected: boolean;
42
- identity?: FlutterDevToolsLauncherIdentity;
43
- };
44
- /** Routes a launcher request from the native client to its paired page. */
45
- type FlutterDevToolsStateLauncherRequest<Request = unknown> = FlutterDevToolsLauncherIdentity & {
46
- request: Request;
47
- };
48
- /** Routes a launcher result from the paired page to its native client. */
49
- type FlutterDevToolsStateLauncherResult<Result = unknown> = FlutterDevToolsLauncherIdentity & {
50
- result: Result;
51
- };
52
- /** Publishes page-owned launcher state to the paired native client. */
53
- type FlutterDevToolsStateLauncherState<State = unknown> = FlutterDevToolsLauncherIdentity & {
54
- state: State;
55
- };
56
- //#endregion
57
- export { FlutterDevToolsIdentity, FlutterDevToolsLauncherIdentity, FlutterDevToolsNativeConnect, FlutterDevToolsPageConnect, FlutterDevToolsReady, FlutterDevToolsStateLauncherConnection, FlutterDevToolsStateLauncherRequest, FlutterDevToolsStateLauncherResult, FlutterDevToolsStateLauncherState, flutterDevToolsEvents, flutterDevToolsProtocolVersion };
@@ -1 +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};