mesurer-solid 0.1.7 → 0.1.8-beta.0

package/AGENT_INTEGRATION.md

@@ -2,7 +2,7 @@
 
 Mesurer's agent integration is the rendered page itself. The coding agent reads `window.__MESURER__` through the browser control it already has, consumes human visual intent, edits normal application source, and verifies the real Live result.
 
-There is no Mesurer MCP server, localhost daemon, Send-to-agent callback, or harness-specific transport.
+The normal agent workflow requires no Mesurer MCP server, localhost daemon, Send-to-agent callback, or harness-specific transport. The optional `codex()` plugin is a separate human convenience path for explicitly sending Context feedback to Codex threads that a local Codex process or the user has registered with the loopback companion; it does not replace the browser-state contract described here.
 
 ## Install the Agent Skill
 
@@ -199,7 +199,15 @@ try {
 }
 ```
 
-The optional `mesurer-solid/screenshot` plugin is a separate human camera workflow. It is not an agent delivery capability. Preserve an existing human preview unless the task is specifically about Screenshot behavior.
+The optional human `screenshot()` plugin from `mesurer-solid/plugins` is a separate camera workflow. It is not an agent delivery capability. Preserve an existing human preview unless the task is specifically about Screenshot behavior.
+
+## Optional human-to-Codex delivery
+
+A source-mounted page may opt into `codex()` from `mesurer-solid/plugins` alongside `context()`. This is not an agent integration requirement and does not add a generic send capability to `window.__MESURER__`.
+
+When the current Codex thread starts `mesurer-codex`, the companion reads Codex's `CODEX_THREAD_ID`, registers that thread, and makes it the default destination. That means a Codex session that starts or uses Mesurer can route later human Context feedback back to the same thread without copying an id by hand. A normal shell may still select the initial session explicitly with `mesurer-codex --thread <SESSION>`.
+
+A different or newly-created Codex thread can join an already-running bridge with `mesurer-codex --register-current`. Registration is accepted only from a local process without a browser Origin. The bridge keeps previously registered threads; the `codex:v1` service can inspect them with `health()`, switch the default with `useThread(thread)`, or send one message to another registered destination with `send({ thread })`. Mesurer does not create or resume Codex threads itself. See [Send Context feedback to Codex](../../docs/CODEX.md).
 
 ## Revalidate after source edits
 

package/README.md

@@ -42,35 +42,35 @@ Full placement examples: [Getting started](https://github.com/jhomra21/mesurer-s
 
 ## First-party plugins
 
+All public first-party plugin factories are exported from `mesurer-solid/plugins` and use the feature name directly:
+
 ```ts
-import {
-  contextPlugin,
-  mountMesurer,
-} from "mesurer-solid"
-import { arrangePlugin } from "mesurer-solid/arrange"
-import { screenshotPlugin } from "mesurer-solid/screenshot"
+import { mountMesurer } from "mesurer-solid"
+import { arrange, context, screenshot } from "mesurer-solid/plugins"
 
 const mesurer = mountMesurer({
   agent: true,
   plugins: [
-    contextPlugin(),
-    arrangePlugin(),
-    screenshotPlugin(),
+    context(),
+    arrange(),
+    screenshot(),
   ],
 })
 ```
 
 The base inspector includes Select, X-ray, Rulers, Typography, Guides, Distance, Settings, plugin hosting, direct text editing, and the low-level inspection API. Native Color Picker is available only when the host exposes an operational `EyeDropper`.
 
+For explicit plugin composition, `mesurer-solid/plugins` also exports `select`, `xray`, `colorPicker`, `rulers`, `typography`, `guides`, `distance`, `settings`, `defaults`, and `compose`.
+
 | Entry | Purpose |
 | --- | --- |
-| `mesurer-solid` | Mount API, context plugin, public types, agent surface |
-| `mesurer-solid/arrange` | Arrange layout-intent plugin |
-| `mesurer-solid/screenshot` | Screenshot capture plugin |
+| `mesurer-solid` | Mount API, public domain types, and agent surface |
+| `mesurer-solid/plugins` | All first-party plugin factories and plugin-specific contracts |
 | `mesurer-solid/core` | Lower-level framework-neutral public contracts |
 | `mesurer-solid/inject` | Programmatic browser injection |
 | `mesurer-solid/inject-script` | Built classic injection artifact |
 | `mesurer-skill` | Install the portable coding-agent skill |
+| `mesurer-codex` | Run the optional loopback Codex queue companion |
 
 ## Features
 
@@ -135,6 +135,43 @@ The skill preserves existing human state, reads Arrange/text/annotation intent b
 
 See [Agent integration](https://github.com/jhomra21/mesurer-solid/blob/main/packages/mesurer/AGENT_INTEGRATION.md).
 
+### Optional Send to Codex
+
+When Codex starts the loopback companion itself, `mesurer-codex` reads `CODEX_THREAD_ID`, so Mesurer feedback naturally routes back to that same Codex CLI/App thread:
+
+```bash
+bunx mesurer-codex
+```
+
+A normal shell can still choose the initial thread explicitly:
+
+```bash
+bunx mesurer-codex --thread <SESSION>
+```
+
+Mount the optional transport next to Context:
+
+```ts
+import { mountMesurer } from "mesurer-solid"
+import { codex, context } from "mesurer-solid/plugins"
+
+mountMesurer({
+  plugins: [context(), codex()],
+})
+```
+
+A different or newly-created Codex thread can register itself with the running bridge and become the active target:
+
+```bash
+bunx mesurer-codex --register-current
+```
+
+The bridge remembers registered threads. `codex:v1` exposes `health()`, `useThread(thread)`, and `send({ thread })` for switching or one-off routing among those registered destinations. Browser pages cannot register arbitrary Codex sessions themselves.
+
+This uses Codex's own queued-user-message command. It does not replace the normal browser-harness agent workflow, and it does not resume or take ownership of a target Codex thread.
+
+See [Send Context feedback to Codex](https://github.com/jhomra21/mesurer-solid/blob/main/docs/CODEX.md).
+
 ## Documentation
 
 - [Getting started](https://github.com/jhomra21/mesurer-solid/blob/main/docs/GETTING_STARTED.md)
@@ -142,6 +179,7 @@ See [Agent integration](https://github.com/jhomra21/mesurer-solid/blob/main/pack
 - [Arrange](https://github.com/jhomra21/mesurer-solid/blob/main/docs/ARRANGE.md)
 - [Screenshots](https://github.com/jhomra21/mesurer-solid/blob/main/docs/SCREENSHOTS.md)
 - [Context workflow](https://github.com/jhomra21/mesurer-solid/blob/main/docs/CONTEXT_WORKFLOW.md)
+- [Send Context feedback to Codex](https://github.com/jhomra21/mesurer-solid/blob/main/docs/CODEX.md)
 - [Browser harness](https://github.com/jhomra21/mesurer-solid/blob/main/docs/BROWSER_HARNESS.md)
 - [Host isolation](https://github.com/jhomra21/mesurer-solid/blob/main/docs/HOST_ISOLATION.md)
 - [Trusted Types](https://github.com/jhomra21/mesurer-solid/blob/main/docs/TRUSTED_TYPES.md)

package/dist/arrange.d.ts

@@ -87,4 +87,4 @@ export type MesurerArrangeService = {
     review(id: string, tolerance?: number): ArrangeReview;
     clear(): Promise<void>;
 };
-export declare const arrangePlugin: () => MesurerPlugin;
+export declare const arrange: () => MesurerPlugin;

package/dist/codex-plugin.d.ts

@@ -0,0 +1,37 @@
+import type { MesurerPlugin } from "./core";
+export declare const MESURER_CODEX_PLUGIN_ID = "mesurer.codex";
+export declare const MESURER_CODEX_SERVICE_ID = "codex:v1";
+export type MesurerCodexPluginOptions = {
+    /** Loopback bridge URL. Defaults to http://127.0.0.1:47365. */
+    endpoint?: string;
+    /** Default instruction prepended to Mesurer evidence. */
+    instruction?: string;
+    /** Show the Send to Codex toolbar action. Defaults to true. */
+    ui?: boolean;
+};
+export type MesurerCodexSendRequest = {
+    /** Optional instruction for this send. */
+    instruction?: string;
+    /** Send only these saved annotation ids. When omitted, all saved annotations are sent. */
+    annotationIds?: string[];
+    /** Send to a particular registered Codex thread without changing the bridge default. */
+    thread?: string;
+};
+export type MesurerCodexSendResult = {
+    thread: string;
+    output: string;
+};
+export type MesurerCodexHealth = {
+    /** Current default target. Null when the bridge has not been bound yet. */
+    thread: string | null;
+    /** Threads explicitly registered by local Codex processes/users. */
+    threads: string[];
+};
+export type MesurerCodexService = {
+    health(): Promise<MesurerCodexHealth>;
+    /** Switch the default target to an already-registered thread. */
+    useThread(thread: string): Promise<MesurerCodexHealth>;
+    /** Send Context to the default target or to one explicitly registered thread. */
+    send(request?: MesurerCodexSendRequest): Promise<MesurerCodexSendResult>;
+};
+export declare function codex(options?: MesurerCodexPluginOptions): MesurerPlugin;

package/dist/context-plugin.d.ts

@@ -18,4 +18,4 @@ export type MesurerContextService = {
     prepareCapture(): Promise<void>;
     finishCapture(): Promise<void>;
 };
-export declare function contextPlugin(options?: MesurerContextPluginOptions): MesurerPlugin;
+export declare function context(options?: MesurerContextPluginOptions): MesurerPlugin;

package/dist/index.d.ts

@@ -3,14 +3,6 @@ import type { ArrangeCapturePlan, ArrangeIntent, ArrangePresentation, ArrangeRev
 import type { MesurerAnnotation, MesurerCapturePlanV1, MesurerContextRequest, MesurerContextV1, MesurerReviewV1 } from "./context";
 import type { MesurerPlugin, MesurerPluginDescription, MesurerPluginHost } from "./core";
 import { type MesurerHostLayerMode } from "./host-layer";
-export type MesurerAvailablePlugin = {
-    id: string;
-    label: string;
-    order?: number;
-    create(): MesurerPlugin | Promise<MesurerPlugin>;
-    settingsIds?: string[];
-    hiddenSettingsControlIds?: string[];
-};
 export type ColorPickerFormat = "hex" | "rgb" | "hsl" | "oklch";
 export type MesurerBuiltinPluginId = "select" | "xray" | "color-picker" | "rulers" | "text-inspector" | "guides" | "distance" | "settings";
 export type LinePattern = "solid" | "dashed" | "dotted";
@@ -142,9 +134,12 @@ export type MesurerOptions = {
     guideStyle?: Partial<GuideStyle>;
     selectionSpacingStyle?: Partial<SelectionSpacingStyle>;
     rulerSettings?: Partial<RulerSettings>;
+    /**
+     * Initial enabled plugin set. Omit this to enable every first-party Mesurer plugin.
+     * Omitted first-party plugins remain toggleable in Settings from the same canonical
+     * registry; callers never maintain a separate availability or Settings list.
+     */
     plugins?: MesurerPlugin[];
-    /** Additional plugins that Settings may load on demand even when initially disabled. */
-    availablePlugins?: MesurerAvailablePlugin[];
     excludePlugins?: MesurerBuiltinPluginId[];
     pluginHost?: MesurerPluginHost;
     onPluginHost?: (host: MesurerPluginHost) => void;
@@ -230,18 +225,6 @@ export type { AgentDistance, AgentEdges, AgentElementInspection, AgentFeedbackSn
 export type { ArrangeCapturePlan, ArrangeIntent, ArrangeOffset, ArrangePresentation, ArrangeRect, ArrangeReview, ArrangeReviewTarget, ArrangeTarget, MesurerArrangeService, } from "./arrange";
 export { captureMesurerContext, copyTextToClipboard, createMesurerCapturePlan, formatMesurerContext, reviewMesurerAnnotation, } from "./context";
 export type { MesurerAnnotation, MesurerAnnotationBaseline, MesurerAnnotationTarget, MesurerCapturePlanV1, MesurerContextDistance, MesurerContextEdges, MesurerContextGuide, MesurerContextMeasurement, MesurerContextRect, MesurerContextRequest, MesurerContextTarget, MesurerContextV1, MesurerElementFingerprint, MesurerElementInspection, MesurerReviewChange, MesurerReviewMetricChange, MesurerReviewPresenceChange, MesurerReviewV1, } from "./context";
-export { contextPlugin, MESURER_CONTEXT_PLUGIN_ID, MESURER_CONTEXT_SERVICE_ID, } from "./context-plugin";
-export type { MesurerContextPluginOptions, MesurerContextService, } from "./context-plugin";
 export { createMesurerPluginHost, createMesurerRuntime, defineMesurerPlugin } from "./core";
 export type { CommandHandler as MesurerCommandHandler, MesurerPlugin, MesurerPluginContext, MesurerPluginDescription, MesurerPluginHost, OverlayContribution, Registration as MesurerRegistration, SettingsContribution, StateSliceDefinition, ToolContribution, } from "./core";
 export type { MesurerHostLayerMode } from "./host-layer";
-export declare const selectPlugin: () => MesurerPlugin;
-export declare const xrayPlugin: () => MesurerPlugin;
-export declare const colorPickerPlugin: () => MesurerPlugin;
-export declare const rulersPlugin: () => MesurerPlugin;
-export declare const textInspectorPlugin: () => MesurerPlugin;
-export declare const guidesPlugin: () => MesurerPlugin;
-export declare const distancePlugin: () => MesurerPlugin;
-export declare const settingsPlugin: () => MesurerPlugin;
-export declare const defaultMesurerPlugins: () => MesurerPlugin[];
-export declare const composeMesurerPlugins: (plugins?: MesurerPlugin[], exclude?: MesurerBuiltinPluginId[]) => MesurerPlugin[];