Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import * as Schema from "effect/Schema";
/**
* Single stack frame captured by react-grab's `getElementContext`. We surface
* the source file/line so coding agents can jump straight to the JSX that
* produced the picked DOM node.
*/
export interface PickedElementStackFrame {
functionName: string | null;
fileName: string | null;
lineNumber: number | null;
columnNumber: number | null;
}
export const PickedElementStackFrameSchema: Schema.Codec<PickedElementStackFrame> = Schema.Struct({
functionName: Schema.NullOr(Schema.String),
fileName: Schema.NullOr(Schema.String),
lineNumber: Schema.NullOr(Schema.Number),
columnNumber: Schema.NullOr(Schema.Number),
});
/**
* A successful element pick from the preview webview. All fields are
* best-effort — pages that don't ship a React fiber tree (or aren't running
* in dev) will still produce a usable payload (selector + html preview),
* just without component / source attribution.
*/
export interface PickedElementPayload {
/** URL of the page the element was picked on. */
pageUrl: string;
/** Optional `<title>` of that page (best-effort). */
pageTitle: string | null;
/** Lowercase tag name, e.g. `"button"`. */
tagName: string;
/** CSS selector resolving back to the element on a re-render. */
selector: string | null;
/** Truncated outer-HTML preview (matches react-grab's `htmlPreview`). */
htmlPreview: string;
/** Nearest React component display name, or null when unavailable. */
componentName: string | null;
/** First source-mapped stack frame (file + line of the JSX source). */
source: PickedElementStackFrame | null;
/** Full owner-stack frames; can be empty. Useful for richer context. */
stack: ReadonlyArray<PickedElementStackFrame>;
/** Author CSS only (UA defaults stripped) — react-grab's `styles`. */
styles: string;
/** Wall-clock pick time as ISO-8601 string. */
pickedAt: string;
}
export const PickedElementPayloadSchema: Schema.Codec<PickedElementPayload> = Schema.Struct({
pageUrl: Schema.String,
pageTitle: Schema.NullOr(Schema.String),
tagName: Schema.String,
selector: Schema.NullOr(Schema.String),
htmlPreview: Schema.String,
componentName: Schema.NullOr(Schema.String),
source: Schema.NullOr(PickedElementStackFrameSchema),
stack: Schema.Array(PickedElementStackFrameSchema),
styles: Schema.String,
pickedAt: Schema.String,
});
export interface PreviewAnnotationRect {
x: number;
y: number;
width: number;
height: number;
}
export const PreviewAnnotationRectSchema: Schema.Codec<PreviewAnnotationRect> = Schema.Struct({
x: Schema.Number,
y: Schema.Number,
width: Schema.Number,
height: Schema.Number,
});
export interface PreviewAnnotationPoint {
x: number;
y: number;
}
export const PreviewAnnotationPointSchema: Schema.Codec<PreviewAnnotationPoint> = Schema.Struct({
x: Schema.Number,
y: Schema.Number,
});
export interface PreviewAnnotationElementTarget {
id: string;
element: PickedElementPayload;
rect: PreviewAnnotationRect;
}
export const PreviewAnnotationElementTargetSchema: Schema.Codec<PreviewAnnotationElementTarget> =
Schema.Struct({
id: Schema.String,
element: PickedElementPayloadSchema,
rect: PreviewAnnotationRectSchema,
});
export interface PreviewAnnotationRegionTarget {
id: string;
rect: PreviewAnnotationRect;
}
export const PreviewAnnotationRegionTargetSchema: Schema.Codec<PreviewAnnotationRegionTarget> =
Schema.Struct({
id: Schema.String,
rect: PreviewAnnotationRectSchema,
});
export interface PreviewAnnotationStrokeTarget {
id: string;
color: string;
width: number;
points: ReadonlyArray<PreviewAnnotationPoint>;
bounds: PreviewAnnotationRect;
}
export const PreviewAnnotationStrokeTargetSchema: Schema.Codec<PreviewAnnotationStrokeTarget> =
Schema.Struct({
id: Schema.String,
color: Schema.String,
width: Schema.Number,
points: Schema.Array(PreviewAnnotationPointSchema),
bounds: PreviewAnnotationRectSchema,
});
export interface PreviewAnnotationStyleChange {
targetId: string;
selector: string | null;
property: string;
previousValue: string;
value: string;
}
export const PreviewAnnotationStyleChangeSchema: Schema.Codec<PreviewAnnotationStyleChange> =
Schema.Struct({
targetId: Schema.String,
selector: Schema.NullOr(Schema.String),
property: Schema.String,
previousValue: Schema.String,
value: Schema.String,
});
export interface PreviewAnnotationScreenshot {
dataUrl: string;
width: number;
height: number;
cropRect: PreviewAnnotationRect;
}
export const PreviewAnnotationScreenshotSchema: Schema.Codec<PreviewAnnotationScreenshot> =
Schema.Struct({
dataUrl: Schema.String,
width: Schema.Number,
height: Schema.Number,
cropRect: PreviewAnnotationRectSchema,
});
/**
* A submitted preview annotation. One annotation may reference multiple DOM
* elements, freeform regions, and ink strokes. The desktop main process adds
* the screenshot after the guest preload submits the structured draft.
*/
export interface PreviewAnnotationPayload {
id: string;
pageUrl: string;
pageTitle: string | null;
comment: string;
elements: ReadonlyArray<PreviewAnnotationElementTarget>;
regions: ReadonlyArray<PreviewAnnotationRegionTarget>;
strokes: ReadonlyArray<PreviewAnnotationStrokeTarget>;
styleChanges: ReadonlyArray<PreviewAnnotationStyleChange>;
screenshot: PreviewAnnotationScreenshot | null;
createdAt: string;
}
export const PreviewAnnotationPayloadSchema: Schema.Codec<PreviewAnnotationPayload> = Schema.Struct(
{
id: Schema.String,
pageUrl: Schema.String,
pageTitle: Schema.NullOr(Schema.String),
comment: Schema.String,
elements: Schema.Array(PreviewAnnotationElementTargetSchema),
regions: Schema.Array(PreviewAnnotationRegionTargetSchema),
strokes: Schema.Array(PreviewAnnotationStrokeTargetSchema),
styleChanges: Schema.Array(PreviewAnnotationStyleChangeSchema),
screenshot: Schema.NullOr(PreviewAnnotationScreenshotSchema),
createdAt: Schema.String,
},
);
export type PreviewAnnotationSubmission = "attach" | "send";
export const PreviewAnnotationSubmissionSchema: Schema.Codec<PreviewAnnotationSubmission> =
Schema.Literals(["attach", "send"]);
export interface PreviewAnnotationSubmissionResult {
annotation: PreviewAnnotationPayload;
submission: PreviewAnnotationSubmission;
}
export const PreviewAnnotationSubmissionResultSchema: Schema.Codec<PreviewAnnotationSubmissionResult> =
Schema.Struct({
annotation: PreviewAnnotationPayloadSchema,
submission: PreviewAnnotationSubmissionSchema,
});