pi-crew 0.6.3 → 0.7.1

package/src/utils/guards.ts

@@ -0,0 +1,110 @@
+/**
+ * Centralized type guard library for pi-crew.
+ *
+ * Inspired by @ayulab/runtime-core — all unknown-to-narrowed checks
+ * go through these helpers instead of inline typeof/instanceof.
+ */
+
+// ── Primitive guards ──────────────────────────────────────────────────
+
+/** Narrow `unknown` to `Record<string, unknown>`. */
+export function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/** Narrow `unknown` to `string`. */
+export function isString(value: unknown): value is string {
+	return typeof value === "string";
+}
+
+/** Narrow `unknown` to a non-empty string. */
+export function isNonEmptyString(value: unknown): value is string {
+	return typeof value === "string" && value.length > 0;
+}
+
+/** Narrow `unknown` to `number` (excludes NaN). */
+export function isNumber(value: unknown): value is number {
+	return typeof value === "number" && !Number.isNaN(value);
+}
+
+/** Narrow `unknown` to `boolean`. */
+export function isBoolean(value: unknown): value is boolean {
+	return typeof value === "boolean";
+}
+
+/** Narrow `unknown` to `readonly string[]`. */
+export function isStringArray(value: unknown): value is readonly string[] {
+	return Array.isArray(value) && value.every((v) => typeof v === "string");
+}
+
+/**
+ * Higher-order guard: build a guard that checks every element of an array.
+ *
+ * @example
+ * const isNumberArray = isArrayOf(isNumber);
+ */
+export function isArrayOf<T>(
+	guard: (item: unknown) => item is T,
+): (value: unknown) => value is readonly T[] {
+	return (value: unknown): value is readonly T[] =>
+		Array.isArray(value) && value.every(guard);
+}
+
+// ── Record field extractors ───────────────────────────────────────────
+
+/** Extract a string field from a record, returning `undefined` if absent. */
+export function getStringField(value: unknown, key: string): string | undefined {
+	if (!isRecord(value)) return undefined;
+	const field = value[key];
+	return typeof field === "string" ? field : undefined;
+}
+
+/** Extract a number field from a record, returning `undefined` if absent. */
+export function getNumberField(value: unknown, key: string): number | undefined {
+	if (!isRecord(value)) return undefined;
+	const field = value[key];
+	return typeof field === "number" && !Number.isNaN(field) ? field : undefined;
+}
+
+/** Extract a boolean field from a record, returning `undefined` if absent. */
+export function getBooleanField(value: unknown, key: string): boolean | undefined {
+	if (!isRecord(value)) return undefined;
+	const field = value[key];
+	return typeof field === "boolean" ? field : undefined;
+}
+
+/** Extract a nested record field from a record, returning `undefined` if absent. */
+export function getRecordField(value: unknown, key: string): Record<string, unknown> | undefined {
+	if (!isRecord(value)) return undefined;
+	const field = value[key];
+	return isRecord(field) ? field : undefined;
+}
+
+/** Extract an array field from a record, returning `undefined` if absent. */
+export function getArrayField(value: unknown, key: string): unknown[] | undefined {
+	if (!isRecord(value)) return undefined;
+	const field = value[key];
+	return Array.isArray(field) ? field : undefined;
+}
+
+// ── Error helpers ─────────────────────────────────────────────────────
+
+/**
+ * Extract a human-readable message from an unknown error value.
+ *
+ * Prefer this over manual `instanceof Error` checks to keep error
+ * handling uniform across the codebase.
+ */
+export function errorMessage(err: unknown): string {
+	return err instanceof Error ? err.message : String(err);
+}
+
+// ── Utility types ─────────────────────────────────────────────────────
+
+/** A non-empty readonly array type. */
+export type NonEmptyReadonlyArray<T> = readonly [T, ...T[]];
+
+/** Narrow a readonly array to a non-empty readonly array. */
+export function hasItems<T>(items: readonly T[]): items is NonEmptyReadonlyArray<T> {
+	return items.length > 0;
+}

package/themes/crew-catppuccin-latte.json

@@ -0,0 +1,96 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-catppuccin-latte",
+	"vars": {
+		"bg": "#eff1f5",
+		"fg": "#4c4f69",
+		"mauve": "#8839ef",
+		"pink": "#ea76cb",
+		"blue": "#1e66f5",
+		"green": "#40a02b",
+		"teal": "#179299",
+		"sky": "#04a5e5",
+		"sapphire": "#209fb5",
+		"red": "#d20f39",
+		"maroon": "#e64553",
+		"peach": "#fe640b",
+		"yellow": "#df8e1d",
+		"rosewater": "#dc8a78",
+		"flamingo": "#dd7878",
+		"lavender": "#7287fd",
+		"gray": "#6c6f85",
+		"dimGray": "#9ca0b0",
+		"darkGray": "#bcc0cc",
+		"darkerGray": "#ccd0da",
+		"selection": "#dcd8f5",
+		"userMsgBg": "#ccd0da",
+		"customMsgBg": "#ccd0da",
+		"toolPending": "#e6e9ef",
+		"toolSuccess": "#e3f0df",
+		"toolError": "#fbe0e3"
+	},
+	"colors": {
+		"accent": "mauve",
+		"border": "darkGray",
+		"borderAccent": "mauve",
+		"borderMuted": "darkerGray",
+		"success": "green",
+		"error": "red",
+		"warning": "peach",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "lavender",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "sky",
+		"toolOutput": "gray",
+
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "green",
+		"mdCodeBlock": "#179299",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "blue",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+
+		"syntaxComment": "#9ca0b0",
+		"syntaxKeyword": "pink",
+		"syntaxFunction": "blue",
+		"syntaxVariable": "peach",
+		"syntaxString": "green",
+		"syntaxNumber": "peach",
+		"syntaxType": "yellow",
+		"syntaxOperator": "sky",
+		"syntaxPunctuation": "fg",
+
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "dimGray",
+		"thinkingLow": "lavender",
+		"thinkingMedium": "mauve",
+		"thinkingHigh": "pink",
+		"thinkingXhigh": "#c896ff",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#eff1f5",
+		"cardBg": "#ccd0da",
+		"infoBg": "#dcd8f5"
+	}
+}

package/themes/crew-catppuccin-mocha.json

@@ -0,0 +1,93 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-catppuccin-mocha",
+	"vars": {
+		"bg": "#1e1e2e",
+		"fg": "#cdd6f4",
+		"mauve": "#cba6f7",
+		"blue": "#89b4fa",
+		"green": "#a6e3a1",
+		"teal": "#94e2d5",
+		"red": "#f38ba8",
+		"peach": "#fab387",
+		"yellow": "#f9e2af",
+		"pink": "#f5c2e7",
+		"sky": "#89dceb",
+		"lavender": "#b4befe",
+		"rosewater": "#f5e0dc",
+		"gray": "#a6adc8",
+		"dimGray": "#6c7086",
+		"darkGray": "#45475a",
+		"darkerGray": "#313244",
+		"selection": "#313244",
+		"userMsgBg": "#181825",
+		"customMsgBg": "#181825",
+		"toolPending": "#11111b",
+		"toolSuccess": "#1a2b1f",
+		"toolError": "#311d24"
+	},
+	"colors": {
+		"accent": "mauve",
+		"border": "darkGray",
+		"borderAccent": "mauve",
+		"borderMuted": "darkerGray",
+		"success": "green",
+		"error": "red",
+		"warning": "peach",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "lavender",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "sky",
+		"toolOutput": "gray",
+
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "green",
+		"mdCodeBlock": "#94e2d5",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "mauve",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+
+		"syntaxComment": "#6c7086",
+		"syntaxKeyword": "#cba6f7",
+		"syntaxFunction": "#89b4fa",
+		"syntaxVariable": "#fab387",
+		"syntaxString": "#a6e3a1",
+		"syntaxNumber": "#fab387",
+		"syntaxType": "#f9e2af",
+		"syntaxOperator": "#89dceb",
+		"syntaxPunctuation": "#cdd6f4",
+
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "#585b70",
+		"thinkingLow": "mauve",
+		"thinkingMedium": "lavender",
+		"thinkingHigh": "pink",
+		"thinkingXhigh": "rosewater",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#1e1e2e",
+		"cardBg": "#181825",
+		"infoBg": "#313244"
+	}
+}

package/themes/crew-dark.json

@@ -0,0 +1,90 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-dark",
+	"vars": {
+		"bg": "#0d1117",
+		"fg": "#c9d1d9",
+		"crewBlue": "#58a6ff",
+		"deepBlue": "#1f6feb",
+		"skyBlue": "#79c0ff",
+		"teal": "#39d353",
+		"amber": "#e3b341",
+		"coral": "#f78166",
+		"rose": "#ff7b72",
+		"lavender": "#d2a8ff",
+		"gray": "#8b949e",
+		"dimGray": "#484f58",
+		"darkGray": "#30363d",
+		"darkerGray": "#21262d",
+		"selection": "#1c2541",
+		"userMsgBg": "#161b22",
+		"customMsgBg": "#161b22",
+		"toolPending": "#111820",
+		"toolSuccess": "#0d1f0d",
+		"toolError": "#2a1215"
+	},
+	"colors": {
+		"accent": "crewBlue",
+		"border": "darkGray",
+		"borderAccent": "deepBlue",
+		"borderMuted": "darkerGray",
+		"success": "teal",
+		"error": "rose",
+		"warning": "amber",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "lavender",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "skyBlue",
+		"toolOutput": "gray",
+
+		"mdHeading": "amber",
+		"mdLink": "deepBlue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "teal",
+		"mdCodeBlock": "#56d364",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "crewBlue",
+
+		"toolDiffAdded": "teal",
+		"toolDiffRemoved": "rose",
+		"toolDiffContext": "gray",
+
+		"syntaxComment": "#6e7681",
+		"syntaxKeyword": "#ff7b72",
+		"syntaxFunction": "#d2a8ff",
+		"syntaxVariable": "#ffa657",
+		"syntaxString": "#a5d6ff",
+		"syntaxNumber": "#79c0ff",
+		"syntaxType": "#ff7b72",
+		"syntaxOperator": "#79c0ff",
+		"syntaxPunctuation": "#c9d1d9",
+
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "#484f58",
+		"thinkingLow": "#1f6feb",
+		"thinkingMedium": "#58a6ff",
+		"thinkingHigh": "#79c0ff",
+		"thinkingXhigh": "#d2a8ff",
+
+		"bashMode": "teal"
+	},
+	"export": {
+		"pageBg": "#0d1117",
+		"cardBg": "#161b22",
+		"infoBg": "#1c2541"
+	}
+}

package/themes/crew-dracula.json

@@ -0,0 +1,83 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-dracula",
+	"vars": {
+		"bg": "#282a36",
+		"fg": "#f8f8f2",
+		"purple": "#bd93f9",
+		"pink": "#ff79c6",
+		"cyan": "#8be9fd",
+		"green": "#50fa7b",
+		"orange": "#ffb86c",
+		"red": "#ff5555",
+		"yellow": "#f1fa8c",
+		"gray": "#6272a4",
+		"dimGray": "#44475a",
+		"darkGray": "#44475a",
+		"darkerGray": "#21222c",
+		"selection": "#44475a",
+		"userMsgBg": "#343746",
+		"customMsgBg": "#343746",
+		"toolPending": "#343746",
+		"toolSuccess": "#1e2d20",
+		"toolError": "#2e1a1e"
+	},
+	"colors": {
+		"accent": "purple",
+		"border": "darkGray",
+		"borderAccent": "purple",
+		"borderMuted": "darkerGray",
+		"success": "green",
+		"error": "red",
+		"warning": "orange",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "cyan",
+		"toolOutput": "gray",
+		"mdHeading": "yellow",
+		"mdLink": "purple",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "green",
+		"mdCodeBlock": "#50fa7b",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "purple",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+		"syntaxComment": "#6272a4",
+		"syntaxKeyword": "pink",
+		"syntaxFunction": "purple",
+		"syntaxVariable": "orange",
+		"syntaxString": "yellow",
+		"syntaxNumber": "purple",
+		"syntaxType": "cyan",
+		"syntaxOperator": "pink",
+		"syntaxPunctuation": "fg",
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "#44475a",
+		"thinkingLow": "purple",
+		"thinkingMedium": "#bd93f9",
+		"thinkingHigh": "cyan",
+		"thinkingXhigh": "pink",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#282a36",
+		"cardBg": "#343746",
+		"infoBg": "#44475a"
+	}
+}

package/themes/crew-gruvbox-dark.json

@@ -0,0 +1,83 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-gruvbox-dark",
+	"vars": {
+		"bg": "#282828",
+		"fg": "#ebdbb2",
+		"blue": "#83a598",
+		"aqua": "#8ec07c",
+		"green": "#b8bb26",
+		"yellow": "#fabd2f",
+		"orange": "#fe8019",
+		"red": "#fb4934",
+		"purple": "#d3869b",
+		"gray": "#928374",
+		"dimGray": "#928374",
+		"darkGray": "#3c3836",
+		"darkerGray": "#1d2021",
+		"selection": "#3c3836",
+		"userMsgBg": "#32302f",
+		"customMsgBg": "#32302f",
+		"toolPending": "#1d2021",
+		"toolSuccess": "#1a2a1a",
+		"toolError": "#2e1a1a"
+	},
+	"colors": {
+		"accent": "blue",
+		"border": "darkGray",
+		"borderAccent": "blue",
+		"borderMuted": "darkerGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "aqua",
+		"toolOutput": "gray",
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "green",
+		"mdCodeBlock": "#b8bb26",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "blue",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+		"syntaxComment": "#928374",
+		"syntaxKeyword": "red",
+		"syntaxFunction": "green",
+		"syntaxVariable": "orange",
+		"syntaxString": "yellow",
+		"syntaxNumber": "purple",
+		"syntaxType": "aqua",
+		"syntaxOperator": "blue",
+		"syntaxPunctuation": "fg",
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "#928374",
+		"thinkingLow": "blue",
+		"thinkingMedium": "#83a598",
+		"thinkingHigh": "aqua",
+		"thinkingXhigh": "purple",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#282828",
+		"cardBg": "#32302f",
+		"infoBg": "#3c3836"
+	}
+}

package/themes/crew-gruvbox-light.json

@@ -0,0 +1,90 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "crew-gruvbox-light",
+	"vars": {
+		"bg": "#fbf1c7",
+		"fg": "#3c3836",
+		"blue": "#076678",
+		"green": "#79740e",
+		"aqua": "#427b58",
+		"yellow": "#d79921",
+		"orange": "#d65d0e",
+		"red": "#cc241d",
+		"purple": "#8f3f71",
+		"fg4": "#7c6f64",
+		"gray": "#928374",
+		"dimGray": "#a89984",
+		"darkGray": "#d5c4a1",
+		"darkerGray": "#ebdbb2",
+		"selection": "#e8d9a8",
+		"userMsgBg": "#ebdbb2",
+		"customMsgBg": "#ebdbb2",
+		"toolPending": "#ebdbb2",
+		"toolSuccess": "#d9e8c0",
+		"toolError": "#f0d0c8"
+	},
+	"colors": {
+		"accent": "blue",
+		"border": "darkGray",
+		"borderAccent": "blue",
+		"borderMuted": "darkerGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "fg",
+		"thinkingText": "gray",
+
+		"selectedBg": "selection",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "fg",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "fg",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "toolPending",
+		"toolSuccessBg": "toolSuccess",
+		"toolErrorBg": "toolError",
+		"toolTitle": "aqua",
+		"toolOutput": "gray",
+
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "green",
+		"mdCodeBlock": "#427b58",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "blue",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+
+		"syntaxComment": "#928374",
+		"syntaxKeyword": "red",
+		"syntaxFunction": "blue",
+		"syntaxVariable": "orange",
+		"syntaxString": "green",
+		"syntaxNumber": "purple",
+		"syntaxType": "aqua",
+		"syntaxOperator": "aqua",
+		"syntaxPunctuation": "fg",
+
+		"thinkingOff": "darkerGray",
+		"thinkingMinimal": "dimGray",
+		"thinkingLow": "purple",
+		"thinkingMedium": "blue",
+		"thinkingHigh": "aqua",
+		"thinkingXhigh": "#1498a8",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#fbf1c7",
+		"cardBg": "#ebdbb2",
+		"infoBg": "#e8d9a8"
+	}
+}