@antelopejs/dms-ai 0.1.5 → 0.2.0

package/frontend-vue/app/chat/types/permission.ts

@@ -1,7 +1,38 @@
+import type {
+	PermissionKind,
+	PermissionPreview,
+	PermissionRule,
+} from "./protocol";
+
+/** A permission request as the approvals dock shows it. */
 export interface PermissionRequestData {
 	requestId: string;
 	conversationId: string;
+	callId?: string;
 	toolName: string;
 	args: unknown;
 	summary: string;
+	kind: PermissionKind;
+	alwaysAsk: boolean;
+	preview: PermissionPreview;
+	ruleOptions: PermissionRule[];
+	createdAtMs: number;
+	expiresAtMs: number;
+}
+
+/** A request the sidecar denied for want of an answer, kept until dismissed. */
+export interface ExpiredRequest {
+	requestId: string;
+	conversationId: string;
+	toolName: string;
+	summary: string;
+	expiredAtMs: number;
+}
+
+/** What the user chose on a card, before it becomes a wire message. */
+export interface PermissionAnswer {
+	decision: "allow_once" | "allow_rule" | "deny";
+	rule?: PermissionRule;
+	feedback?: string;
+	keepData?: boolean;
 }

package/frontend-vue/app/chat/types/protocol.ts

@@ -0,0 +1,226 @@
+/**
+ * The sidecar's wire shapes the chat reads, mirrored by hand like the message
+ * types (sidecar/src/protocol). Every field the redesign added is optional
+ * here: the chat must keep working against a sidecar that does not send it yet.
+ */
+
+export type ProviderName = "claude" | "codex";
+export type ApprovalMode = "normal" | "acceptEdits" | "plan";
+export type Scope = "safe" | "vibe";
+export type FullAutoDuration = "turn" | "30m" | "chat";
+
+export type ToolOutcome = "done" | "failed" | "denied" | "blocked" | "stopped";
+
+export type AllowedBy =
+	| "read_auto"
+	| "builder_auto"
+	| "approved"
+	| "rule"
+	| "full_auto"
+	| "blocked"
+	| "denied"
+	| "expired";
+
+export type RuleKind = "file" | "directory" | "command" | "domain";
+
+export interface PermissionRule {
+	kind: RuleKind;
+	value: string;
+}
+
+export interface ActiveRule extends PermissionRule {
+	id: string;
+	label: string;
+	createdAtMs: number;
+}
+
+export type DiffLineKind = "context" | "add" | "remove";
+
+export interface DiffLine {
+	kind: DiffLineKind;
+	text: string;
+	oldLine?: number;
+	newLine?: number;
+}
+
+export interface DiffHunk {
+	oldStart: number;
+	newStart: number;
+	lines: DiffLine[];
+}
+
+export interface DiffPreview {
+	type: "diff";
+	path: string;
+	relativePath: string;
+	isNewFile: boolean;
+	added: number;
+	removed: number;
+	hunks: DiffHunk[];
+}
+
+type CommandEffect = "adds_dependency" | "removes_dependency";
+
+export interface CommandPreview {
+	type: "command";
+	command: string;
+	cwd: string;
+	effect?: CommandEffect;
+	touches?: string[];
+}
+
+type DestructiveConsequence = "deletes_data" | "removes_code";
+
+export interface DestructivePreview {
+	type: "destructive";
+	operation: string;
+	target: string;
+	consequence: DestructiveConsequence;
+	confirmText?: string;
+	canKeepData: boolean;
+}
+
+export interface WebPreview {
+	type: "web";
+	url: string;
+	host: string;
+}
+
+interface GenericPreview {
+	type: "generic";
+	args: Record<string, unknown>;
+}
+
+export type PermissionPreview =
+	| DiffPreview
+	| CommandPreview
+	| DestructivePreview
+	| WebPreview
+	| GenericPreview;
+
+export type PermissionKind =
+	| "edit"
+	| "command"
+	| "web"
+	| "destructive"
+	| "builder"
+	| "other";
+
+export type ChangeSetState = "applied" | "undone";
+export type TypecheckOutcome = "passed" | "failed" | "skipped";
+export type ChangeSetFileStatus = "added" | "modified" | "deleted";
+
+export interface ChangeSetFile {
+	path: string;
+	status: ChangeSetFileStatus;
+	added: number;
+	removed: number;
+}
+
+export interface ChangeSetSummary {
+	id: string;
+	number: number;
+	conversationId: string;
+	title: string;
+	createdAtMs: number;
+	agent: ProviderName;
+	scope: Scope;
+	isAutoFix: boolean;
+	overlapped: boolean;
+	files: ChangeSetFile[];
+	added: number;
+	removed: number;
+	typecheck: TypecheckOutcome;
+	state: ChangeSetState;
+	stateChangedAtMs?: number;
+	stateChangedBy?: string;
+	askedBy?: string;
+	approvalsNeeded: number;
+	builderOps: number;
+}
+
+export interface AutoFixNotice {
+	kind: "autofix";
+	attempt: number;
+	maxAttempts: number;
+	errors: string[];
+	timestampMs: number;
+}
+
+export interface PermissionExpiredNotice {
+	kind: "permission_expired";
+	toolName: string;
+	summary: string;
+	timestampMs: number;
+}
+
+export interface QuestionSkippedNotice {
+	kind: "question_skipped";
+	header: string;
+	timestampMs: number;
+}
+
+export interface FullAutoEndedNotice {
+	kind: "full_auto_ended";
+	timestampMs: number;
+}
+
+export type Notice =
+	| AutoFixNotice
+	| PermissionExpiredNotice
+	| QuestionSkippedNotice
+	| FullAutoEndedNotice;
+
+export interface FullAutoState {
+	duration: FullAutoDuration;
+	untilMs?: number;
+}
+
+export interface ConversationModeState {
+	mode: ApprovalMode;
+	generationMode: Scope;
+	fullAuto: FullAutoState | null;
+}
+
+export interface QuestionAnswerRecord {
+	header: string;
+	question: string;
+	answer: string | null;
+	skipped: boolean;
+	isCustom: boolean;
+}
+
+export interface WireAttachment {
+	name: string;
+	mimeType: string;
+	size: number;
+	data: string;
+}
+
+export interface AttachmentMeta {
+	name: string;
+	mimeType: string;
+	size: number;
+}
+
+export interface SnapshotMessage {
+	role: string;
+	content: string;
+	toolName?: string;
+	callId?: string;
+	status?: string;
+	attachments?: AttachmentMeta[];
+	isRetryable?: boolean;
+	timestampMs: number;
+	outcome?: ToolOutcome;
+	allowedBy?: AllowedBy;
+	changeSetId?: string;
+	notice?: Notice;
+	answers?: QuestionAnswerRecord[];
+}
+
+export interface QueuedItemWire {
+	id: string;
+	content: string;
+	attachments?: WireAttachment[];
+}

package/frontend-vue/app/chat/types/question.ts

@@ -1,4 +1,4 @@
-export interface QuestionOptionData {
+interface QuestionOptionData {
 	label: string;
 	description: string;
 	preview?: string;
@@ -14,4 +14,13 @@ export interface QuestionRequestData {
 	requestId: string;
 	conversationId: string;
 	questions: QuestionData[];
+	createdAtMs: number;
+	expiresAtMs: number;
+}
+
+/** One question's answer: an option label, the user's own words, or skipped. */
+export interface QuestionReply {
+	answer: string;
+	isCustom: boolean;
+	skipped: boolean;
 }

package/frontend-vue/app/chat/types/settings.ts

@@ -1,7 +1,7 @@
-export type ChatMode = "normal" | "acceptEdits" | "plan" | "auto";
+import type { ApprovalMode, ProviderName, Scope } from "./protocol";
+
 export type ThinkingLevel = "off" | "low" | "medium" | "high";
-export type GenerationMode = "safe" | "vibe";
-export type ProviderName = "claude" | "codex";
+export type { ProviderName };
 
 export interface ProviderAvailability {
 	available: boolean;
@@ -11,10 +11,14 @@ export interface ProviderAvailability {
 
 export interface AppSettings {
 	provider: ProviderName;
-	mode: ChatMode;
+	/** The default approval mode of new chats. */
+	mode: ApprovalMode;
 	thinking: ThinkingLevel;
-	generationMode: GenerationMode;
+	/** The default scope of new chats. */
+	generationMode: Scope;
 	allowLocalSkills: boolean;
+	notifyRequests: boolean;
+	requestTimeoutMinutes: number;
 	/**
 	 * Read-only capability pushed by the sidecar: whether the Builder is present.
 	 */

package/frontend-vue/app/chat/utils/approval-keyboard.ts

@@ -0,0 +1,49 @@
+export type ApprovalKeyAction = "allow" | "deny" | "next" | "previous";
+
+/** The slice of a keyboard event the approvals dock reads. */
+export interface ApprovalKeyInput {
+	key: string;
+	shiftKey: boolean;
+	metaKey: boolean;
+	ctrlKey: boolean;
+	altKey: boolean;
+	/** The key went to a text field (a suggestion, a name to type): it is text. */
+	isTextTarget: boolean;
+}
+
+const ACTION_BY_KEY: Record<string, ApprovalKeyAction> = {
+	enter: "allow",
+	n: "deny",
+	j: "next",
+	k: "previous",
+};
+
+/** ↵ allows, N denies, J and K move between requests; anything else is not ours. */
+export function approvalKeyAction(
+	input: ApprovalKeyInput,
+): ApprovalKeyAction | null {
+	if (input.isTextTarget) return null;
+	if (input.metaKey || input.ctrlKey || input.altKey || input.shiftKey)
+		return null;
+	return ACTION_BY_KEY[input.key.toLowerCase()] ?? null;
+}
+
+const TEXT_TARGET_SELECTOR =
+	"input, textarea, select, [contenteditable='true']";
+
+/** Whether the element takes typed text, so the dock's letter keys stay text. */
+export function isTextTarget(target: EventTarget | null): boolean {
+	return (
+		target instanceof Element && target.closest(TEXT_TARGET_SELECTOR) !== null
+	);
+}
+
+/** The index after moving by `step` within `total`, wrapping around. */
+export function stepIndex(
+	current: number,
+	step: number,
+	total: number,
+): number {
+	if (total === 0) return 0;
+	return (((current + step) % total) + total) % total;
+}

package/frontend-vue/app/chat/utils/arrays.ts

@@ -0,0 +1,10 @@
+/** The last element matching, like `Array.prototype.findLast` (ES2023). */
+export function lastMatching<T>(
+	list: readonly T[],
+	predicate: (item: T) => boolean,
+): T | undefined {
+	for (let index = list.length - 1; index >= 0; index -= 1) {
+		if (predicate(list[index])) return list[index];
+	}
+	return undefined;
+}

package/frontend-vue/app/chat/utils/conversation-groups.ts

@@ -0,0 +1,96 @@
+import type { ConversationSummary } from "../types/conversation";
+
+type ConversationGroupKey = "active" | "today" | "week" | "older";
+
+export interface ConversationGroup {
+	key: ConversationGroupKey;
+	items: ConversationSummary[];
+}
+
+const DAYS_IN_WEEK = 7;
+const GROUP_ORDER: readonly ConversationGroupKey[] = [
+	"active",
+	"today",
+	"week",
+	"older",
+];
+
+/** Working, or waiting on the user: pinned on top so it never times out unseen. */
+function isActiveConversation(item: ConversationSummary): boolean {
+	return (
+		item.isRunning === true ||
+		(item.pendingApprovals ?? 0) > 0 ||
+		(item.pendingQuestions ?? 0) > 0
+	);
+}
+
+function startOfDay(ms: number): number {
+	const date = new Date(ms);
+	date.setHours(0, 0, 0, 0);
+	return date.getTime();
+}
+
+function startOfDaysAgo(nowMs: number, days: number): number {
+	const date = new Date(startOfDay(nowMs));
+	date.setDate(date.getDate() - days);
+	return date.getTime();
+}
+
+function groupOf(
+	item: ConversationSummary,
+	nowMs: number,
+): ConversationGroupKey {
+	if (isActiveConversation(item)) return "active";
+	if (item.updatedAtMs >= startOfDay(nowMs)) return "today";
+	if (item.updatedAtMs >= startOfDaysAgo(nowMs, DAYS_IN_WEEK - 1))
+		return "week";
+	return "older";
+}
+
+function matches(item: ConversationSummary, search: string): boolean {
+	const needle = search.trim().toLocaleLowerCase();
+	if (needle === "") return true;
+	return item.title.toLocaleLowerCase().includes(needle);
+}
+
+/**
+ * The drawer's sections: Active pinned above Today, This week and Older,
+ * newest first within each, filtered by the search, empty sections dropped.
+ */
+export function groupConversations(
+	items: readonly ConversationSummary[],
+	nowMs: number,
+	search = "",
+): ConversationGroup[] {
+	const sorted = items
+		.filter((item) => matches(item, search))
+		.sort((a, b) => b.updatedAtMs - a.updatedAtMs);
+	return GROUP_ORDER.map((key) => ({
+		key,
+		items: sorted.filter((item) => groupOf(item, nowMs) === key),
+	})).filter((group) => group.items.length > 0);
+}
+
+const MS_PER_MINUTE = 60_000;
+const MINUTES_PER_HOUR = 60;
+
+/** The drawer's time: now, minutes ago, a time today, a weekday, a date. */
+export function conversationTime(
+	timestampMs: number,
+	nowMs: number,
+	locale: string,
+	nowLabel: string,
+): string {
+	const minutes = Math.floor((nowMs - timestampMs) / MS_PER_MINUTE);
+	if (minutes < 1) return nowLabel;
+	if (minutes < MINUTES_PER_HOUR) return `${minutes}m`;
+	const date = new Date(timestampMs);
+	if (timestampMs >= startOfDay(nowMs))
+		return date.toLocaleTimeString(locale, {
+			hour: "2-digit",
+			minute: "2-digit",
+		});
+	if (timestampMs >= startOfDaysAgo(nowMs, DAYS_IN_WEEK - 1))
+		return date.toLocaleDateString(locale, { weekday: "short" });
+	return date.toLocaleDateString(locale, { month: "short", day: "numeric" });
+}