@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/interaction/askUserQuestionTypes.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for askUserQuestion.
+ * Extracted from askUserQuestion.ts for max-lines compliance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interaction/commandDiscovery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Command discovery — a registry for slash commands and interactive
+ * actions with category-based listing and fuzzy search (UX-011).
+ */
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    category: string;
+    aliases?: string[];
+    hidden?: boolean;
+}
+export interface CommandSuggestion {
+    command: CommandDefinition;
+    score: number;
+}
+export declare class CommandRegistry {
+    private commands;
+    /** Register a command. Replaces any existing command with the same name. */
+    register(command: CommandDefinition): void;
+    /** Unregister a command by name. Returns true if it existed. */
+    unregister(name: string): boolean;
+    /** Get a command by exact name or alias. */
+    get(name: string): CommandDefinition | undefined;
+    /** List all visible commands, optionally filtered by category. */
+    listByCategory(category?: string): CommandDefinition[];
+    /** Return all distinct categories across registered commands. */
+    getCategories(): string[];
+    /** Search commands by a query string matching name, aliases, or description. */
+    search(query: string): CommandDefinition[];
+    /**
+     * Get ranked suggestions for a partial query. Hidden commands are excluded.
+     * Results are sorted by descending score.
+     */
+    getSuggestions(partial: string, limit?: number): CommandSuggestion[];
+    /** Total number of registered commands. */
+    get size(): number;
+}
+//# sourceMappingURL=commandDiscovery.d.ts.map

package/dist/interaction/commandDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandDiscovery.d.ts","sourceRoot":"","sources":["../../src/interaction/commandDiscovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IAMxD,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI1C,gEAAgE;IAChE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,4CAA4C;IAC5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAehD,kEAAkE;IAClE,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQtD,iEAAiE;IACjE,aAAa,IAAI,MAAM,EAAE;IAQzB,gFAAgF;IAChF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1C;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,iBAAiB,EAAE;IAmC/D,2CAA2C;IAC3C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/interaction/commandDiscovery.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Command discovery — a registry for slash commands and interactive
+ * actions with category-based listing and fuzzy search (UX-011).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandRegistry = void 0;
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+class CommandRegistry {
+    commands = new Map();
+    // -----------------------------------------------------------------------
+    // Registration
+    // -----------------------------------------------------------------------
+    /** Register a command. Replaces any existing command with the same name. */
+    register(command) {
+        this.commands.set(command.name, command);
+    }
+    /** Unregister a command by name. Returns true if it existed. */
+    unregister(name) {
+        return this.commands.delete(name);
+    }
+    /** Get a command by exact name or alias. */
+    get(name) {
+        const direct = this.commands.get(name);
+        if (direct)
+            return direct;
+        // Check aliases
+        for (const cmd of this.commands.values()) {
+            if (cmd.aliases?.includes(name))
+                return cmd;
+        }
+        return undefined;
+    }
+    // -----------------------------------------------------------------------
+    // Querying
+    // -----------------------------------------------------------------------
+    /** List all visible commands, optionally filtered by category. */
+    listByCategory(category) {
+        const all = [...this.commands.values()].filter((c) => !c.hidden);
+        if (category) {
+            return all.filter((c) => c.category === category);
+        }
+        return all;
+    }
+    /** Return all distinct categories across registered commands. */
+    getCategories() {
+        const cats = new Set();
+        for (const cmd of this.commands.values()) {
+            cats.add(cmd.category);
+        }
+        return [...cats].sort();
+    }
+    /** Search commands by a query string matching name, aliases, or description. */
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        return [...this.commands.values()].filter((cmd) => {
+            if (cmd.name.toLowerCase().includes(lowerQuery))
+                return true;
+            if (cmd.description.toLowerCase().includes(lowerQuery))
+                return true;
+            if (cmd.aliases?.some((a) => a.toLowerCase().includes(lowerQuery)))
+                return true;
+            return false;
+        });
+    }
+    /**
+     * Get ranked suggestions for a partial query. Hidden commands are excluded.
+     * Results are sorted by descending score.
+     */
+    getSuggestions(partial, limit = 5) {
+        const lowerPartial = partial.toLowerCase();
+        const scored = [];
+        for (const cmd of this.commands.values()) {
+            if (cmd.hidden)
+                continue;
+            let score = 0;
+            // Exact prefix match on name scores highest
+            if (cmd.name.toLowerCase().startsWith(lowerPartial)) {
+                score += 100;
+            }
+            else if (cmd.name.toLowerCase().includes(lowerPartial)) {
+                score += 50;
+            }
+            // Alias match
+            if (cmd.aliases?.some((a) => a.toLowerCase().startsWith(lowerPartial))) {
+                score += 80;
+            }
+            // Description match
+            if (cmd.description.toLowerCase().includes(lowerPartial)) {
+                score += 20;
+            }
+            if (score > 0) {
+                scored.push({ command: cmd, score });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+    /** Total number of registered commands. */
+    get size() {
+        return this.commands.size;
+    }
+}
+exports.CommandRegistry = CommandRegistry;

package/dist/interaction/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./askUserQuestion";
+export { resolveInteractionUxHints } from './interactionRouter';
+export type { InteractionUxHints } from './interactionRouter';
+export { SteeringQueue } from './steering';
+export type { SteeringMessage, SteeringMessageType } from './steering';
+export { createModelSwitchState, switchModel, cycleFavorite, addFavorite, removeFavorite, } from './model-switch';
+export type { ModelSwitchState } from './model-switch';
+export { CommandRegistry, type CommandDefinition, type CommandSuggestion, } from './commandDiscovery';
+export { formatApprovalPrompt, parseApprovalResponse, getDefaultApprovalForRisk, type ApprovalPrompt, type RiskLevel, type ApprovalAction, } from './permissionApprovalUi';
+export { BUILT_IN_PATTERNS, getPatternForEffect, validateEffectInput, formatEffectSummary, type EffectInteractionPattern, type EffectLike, type SchemaField, type RenderHints, type ValidationResult, type ValidationError, } from './typedEffectPatterns';
+//# sourceMappingURL=index.d.ts.map

package/dist/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/interaction/index.js

@@ -0,0 +1,42 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatEffectSummary = exports.validateEffectInput = exports.getPatternForEffect = exports.BUILT_IN_PATTERNS = exports.getDefaultApprovalForRisk = exports.parseApprovalResponse = exports.formatApprovalPrompt = exports.CommandRegistry = exports.removeFavorite = exports.addFavorite = exports.cycleFavorite = exports.switchModel = exports.createModelSwitchState = exports.SteeringQueue = exports.resolveInteractionUxHints = void 0;
+__exportStar(require("./askUserQuestion"), exports);
+var interactionRouter_1 = require("./interactionRouter");
+Object.defineProperty(exports, "resolveInteractionUxHints", { enumerable: true, get: function () { return interactionRouter_1.resolveInteractionUxHints; } });
+var steering_1 = require("./steering");
+Object.defineProperty(exports, "SteeringQueue", { enumerable: true, get: function () { return steering_1.SteeringQueue; } });
+var model_switch_1 = require("./model-switch");
+Object.defineProperty(exports, "createModelSwitchState", { enumerable: true, get: function () { return model_switch_1.createModelSwitchState; } });
+Object.defineProperty(exports, "switchModel", { enumerable: true, get: function () { return model_switch_1.switchModel; } });
+Object.defineProperty(exports, "cycleFavorite", { enumerable: true, get: function () { return model_switch_1.cycleFavorite; } });
+Object.defineProperty(exports, "addFavorite", { enumerable: true, get: function () { return model_switch_1.addFavorite; } });
+Object.defineProperty(exports, "removeFavorite", { enumerable: true, get: function () { return model_switch_1.removeFavorite; } });
+// Command discovery (UX-011)
+var commandDiscovery_1 = require("./commandDiscovery");
+Object.defineProperty(exports, "CommandRegistry", { enumerable: true, get: function () { return commandDiscovery_1.CommandRegistry; } });
+// Permission approval UI (GAP-UX-001c)
+var permissionApprovalUi_1 = require("./permissionApprovalUi");
+Object.defineProperty(exports, "formatApprovalPrompt", { enumerable: true, get: function () { return permissionApprovalUi_1.formatApprovalPrompt; } });
+Object.defineProperty(exports, "parseApprovalResponse", { enumerable: true, get: function () { return permissionApprovalUi_1.parseApprovalResponse; } });
+Object.defineProperty(exports, "getDefaultApprovalForRisk", { enumerable: true, get: function () { return permissionApprovalUi_1.getDefaultApprovalForRisk; } });
+// Typed effect interaction patterns (GAP-UX-010)
+var typedEffectPatterns_1 = require("./typedEffectPatterns");
+Object.defineProperty(exports, "BUILT_IN_PATTERNS", { enumerable: true, get: function () { return typedEffectPatterns_1.BUILT_IN_PATTERNS; } });
+Object.defineProperty(exports, "getPatternForEffect", { enumerable: true, get: function () { return typedEffectPatterns_1.getPatternForEffect; } });
+Object.defineProperty(exports, "validateEffectInput", { enumerable: true, get: function () { return typedEffectPatterns_1.validateEffectInput; } });
+Object.defineProperty(exports, "formatEffectSummary", { enumerable: true, get: function () { return typedEffectPatterns_1.formatEffectSummary; } });

package/dist/interaction/interactionRouter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GAP-SEC-003: Interaction UX Routing
+ *
+ * Maps InteractionKind values to UX hints that harness adapters
+ * consume for kind-appropriate rendering.
+ *
+ * @module interaction/interactionRouter
+ */
+import type { InteractionKind } from '@a5c-ai/babysitter-sdk';
+/**
+ * UX hints for rendering a specific interaction kind.
+ */
+export interface InteractionUxHints {
+    urgency: 'low' | 'medium' | 'high';
+    requiresDecision: boolean;
+    presentAlwaysApprove: boolean;
+    defaultAutoApprove: boolean;
+    uiStyle: 'qa' | 'confirm' | 'alert' | 'banner' | 'summary';
+}
+/**
+ * Resolve UX hints for a given interaction kind.
+ * Pure function — no I/O.
+ */
+export declare function resolveInteractionUxHints(kind: InteractionKind): InteractionUxHints | undefined;
+//# sourceMappingURL=interactionRouter.d.ts.map

package/dist/interaction/interactionRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionRouter.d.ts","sourceRoot":"","sources":["../../src/interaction/interactionRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5D;AAwCD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAE/F"}

package/dist/interaction/interactionRouter.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * GAP-SEC-003: Interaction UX Routing
+ *
+ * Maps InteractionKind values to UX hints that harness adapters
+ * consume for kind-appropriate rendering.
+ *
+ * @module interaction/interactionRouter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveInteractionUxHints = resolveInteractionUxHints;
+const HINTS_MAP = {
+    clarification: {
+        urgency: 'low',
+        requiresDecision: true,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'qa',
+    },
+    approval: {
+        urgency: 'medium',
+        requiresDecision: true,
+        presentAlwaysApprove: true,
+        defaultAutoApprove: false,
+        uiStyle: 'confirm',
+    },
+    intervention: {
+        urgency: 'high',
+        requiresDecision: true,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'alert',
+    },
+    notification: {
+        urgency: 'low',
+        requiresDecision: false,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: true,
+        uiStyle: 'banner',
+    },
+    handoff: {
+        urgency: 'low',
+        requiresDecision: false,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'summary',
+    },
+};
+/**
+ * Resolve UX hints for a given interaction kind.
+ * Pure function — no I/O.
+ */
+function resolveInteractionUxHints(kind) {
+    return HINTS_MAP[kind];
+}

package/dist/interaction/model-switch.d.ts

@@ -0,0 +1,16 @@
+export interface ModelSwitchState {
+    currentModel: string;
+    currentProvider: string;
+    favorites: string[];
+    history: Array<{
+        model: string;
+        provider: string;
+        switchedAt: string;
+    }>;
+}
+export declare function createModelSwitchState(initialModel: string, initialProvider: string): ModelSwitchState;
+export declare function switchModel(state: ModelSwitchState, model: string, provider?: string): void;
+export declare function cycleFavorite(state: ModelSwitchState): string | undefined;
+export declare function addFavorite(state: ModelSwitchState, model: string): void;
+export declare function removeFavorite(state: ModelSwitchState, model: string): void;
+//# sourceMappingURL=model-switch.d.ts.map

package/dist/interaction/model-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-switch.d.ts","sourceRoot":"","sources":["../../src/interaction/model-switch.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,gBAAgB,CAOtG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ3F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3E"}

package/dist/interaction/model-switch.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModelSwitchState = createModelSwitchState;
+exports.switchModel = switchModel;
+exports.cycleFavorite = cycleFavorite;
+exports.addFavorite = addFavorite;
+exports.removeFavorite = removeFavorite;
+function createModelSwitchState(initialModel, initialProvider) {
+    return {
+        currentModel: initialModel,
+        currentProvider: initialProvider,
+        favorites: [],
+        history: [{ model: initialModel, provider: initialProvider, switchedAt: new Date().toISOString() }],
+    };
+}
+function switchModel(state, model, provider) {
+    state.currentModel = model;
+    if (provider)
+        state.currentProvider = provider;
+    state.history.push({
+        model,
+        provider: provider ?? state.currentProvider,
+        switchedAt: new Date().toISOString(),
+    });
+}
+function cycleFavorite(state) {
+    if (state.favorites.length === 0)
+        return undefined;
+    const currentIdx = state.favorites.indexOf(state.currentModel);
+    const nextIdx = (currentIdx + 1) % state.favorites.length;
+    const next = state.favorites[nextIdx];
+    switchModel(state, next);
+    return next;
+}
+function addFavorite(state, model) {
+    if (!state.favorites.includes(model))
+        state.favorites.push(model);
+}
+function removeFavorite(state, model) {
+    state.favorites = state.favorites.filter(m => m !== model);
+}

package/dist/interaction/permissionApprovalUi.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Permission and breakpoint approval UI — format approval prompts,
+ * parse operator responses, and provide sensible defaults per risk
+ * level (GAP-UX-001c).
+ */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export type ApprovalAction = 'approve' | 'deny' | 'modify';
+export interface ApprovalPrompt {
+    action: string;
+    riskLevel: RiskLevel;
+    context: string;
+    options: string[];
+}
+/**
+ * Render a styled approval request as text.
+ */
+export declare function formatApprovalPrompt(prompt: ApprovalPrompt): string;
+/**
+ * Extract an approval action from free-form user input.
+ * Returns undefined if the input cannot be classified.
+ */
+export declare function parseApprovalResponse(input: string): ApprovalAction | undefined;
+/**
+ * Return the default approval action for a given risk level.
+ *
+ * - low    → approve (auto-approve safe actions)
+ * - medium → approve (lean towards progress)
+ * - high   → deny   (require explicit approval)
+ * - critical → deny (require explicit approval)
+ */
+export declare function getDefaultApprovalForRisk(riskLevel: RiskLevel): ApprovalAction;
+//# sourceMappingURL=permissionApprovalUi.d.ts.map

package/dist/interaction/permissionApprovalUi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionApprovalUi.d.ts","sourceRoot":"","sources":["../../src/interaction/permissionApprovalUi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAkBnE;AAUD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAuB/E;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAS9E"}

package/dist/interaction/permissionApprovalUi.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Permission and breakpoint approval UI — format approval prompts,
+ * parse operator responses, and provide sensible defaults per risk
+ * level (GAP-UX-001c).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatApprovalPrompt = formatApprovalPrompt;
+exports.parseApprovalResponse = parseApprovalResponse;
+exports.getDefaultApprovalForRisk = getDefaultApprovalForRisk;
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+const RISK_ICON = {
+    low: '[LOW]',
+    medium: '[MED]',
+    high: '[HIGH]',
+    critical: '[CRIT]',
+};
+/**
+ * Render a styled approval request as text.
+ */
+function formatApprovalPrompt(prompt) {
+    const lines = [];
+    const divider = '─'.repeat(50);
+    lines.push(divider);
+    lines.push(`  ${RISK_ICON[prompt.riskLevel]} Approval Required`);
+    lines.push(divider);
+    lines.push(`  Action:  ${prompt.action}`);
+    lines.push(`  Risk:    ${prompt.riskLevel}`);
+    lines.push(`  Context: ${prompt.context}`);
+    lines.push('');
+    lines.push('  Options:');
+    for (const opt of prompt.options) {
+        lines.push(`    - ${opt}`);
+    }
+    lines.push(divider);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+const APPROVE_TOKENS = new Set(['approve', 'yes', 'y', 'ok', 'allow', 'accept', 'proceed']);
+const DENY_TOKENS = new Set(['deny', 'no', 'n', 'reject', 'block', 'cancel', 'abort']);
+const MODIFY_TOKENS = new Set(['modify', 'edit', 'change', 'update', 'adjust']);
+/**
+ * Extract an approval action from free-form user input.
+ * Returns undefined if the input cannot be classified.
+ */
+function parseApprovalResponse(input) {
+    const normalised = input.trim().toLowerCase();
+    // Exact match first
+    if (APPROVE_TOKENS.has(normalised))
+        return 'approve';
+    if (DENY_TOKENS.has(normalised))
+        return 'deny';
+    if (MODIFY_TOKENS.has(normalised))
+        return 'modify';
+    // Word-boundary match for multi-word input (e.g. "yes, approve it")
+    // Only match tokens >= 2 chars to avoid false positives from "y"/"n"
+    const words = normalised.split(/\W+/).filter(Boolean);
+    for (const word of words) {
+        if (APPROVE_TOKENS.has(word))
+            return 'approve';
+    }
+    for (const word of words) {
+        if (DENY_TOKENS.has(word))
+            return 'deny';
+    }
+    for (const word of words) {
+        if (MODIFY_TOKENS.has(word))
+            return 'modify';
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+/**
+ * Return the default approval action for a given risk level.
+ *
+ * - low    → approve (auto-approve safe actions)
+ * - medium → approve (lean towards progress)
+ * - high   → deny   (require explicit approval)
+ * - critical → deny (require explicit approval)
+ */
+function getDefaultApprovalForRisk(riskLevel) {
+    switch (riskLevel) {
+        case 'low':
+        case 'medium':
+            return 'approve';
+        case 'high':
+        case 'critical':
+            return 'deny';
+    }
+}

package/dist/interaction/steering.d.ts

@@ -0,0 +1,17 @@
+export type SteeringMessageType = 'steer' | 'followup';
+export interface SteeringMessage {
+    type: SteeringMessageType;
+    content: string;
+    timestamp: string;
+    authorId?: string;
+}
+export declare class SteeringQueue {
+    private queue;
+    private listeners;
+    submit(content: string, type?: SteeringMessageType, authorId?: string): void;
+    drain(type?: SteeringMessageType): SteeringMessage[];
+    peek(): SteeringMessage[];
+    get pending(): number;
+    onMessage(listener: (msg: SteeringMessage) => void): () => void;
+}
+//# sourceMappingURL=steering.d.ts.map

package/dist/interaction/steering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../src/interaction/steering.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAA6C;IAE9D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,mBAA6B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAWrF,KAAK,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,eAAe,EAAE;IAWpD,IAAI,IAAI,eAAe,EAAE;IAIzB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;CAMhE"}

package/dist/interaction/steering.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SteeringQueue = void 0;
+class SteeringQueue {
+    queue = [];
+    listeners = [];
+    submit(content, type = 'steer', authorId) {
+        const msg = {
+            type,
+            content,
+            timestamp: new Date().toISOString(),
+            authorId,
+        };
+        this.queue.push(msg);
+        for (const listener of this.listeners)
+            listener(msg);
+    }
+    drain(type) {
+        if (type) {
+            const matching = this.queue.filter(m => m.type === type);
+            this.queue = this.queue.filter(m => m.type !== type);
+            return matching;
+        }
+        const all = [...this.queue];
+        this.queue = [];
+        return all;
+    }
+    peek() {
+        return [...this.queue];
+    }
+    get pending() {
+        return this.queue.length;
+    }
+    onMessage(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter(l => l !== listener);
+        };
+    }
+}
+exports.SteeringQueue = SteeringQueue;

package/dist/interaction/typedEffectPatterns.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Typed effect interaction patterns (GAP-UX-010).
+ *
+ * Defines interaction patterns for each effect kind — input schemas,
+ * output schemas, and rendering hints — so UIs can present effects
+ * consistently and validate user input.
+ */
+export interface SchemaField {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required?: boolean;
+    description?: string;
+}
+export interface RenderHints {
+    /** Preferred UI widget. */
+    widget: 'terminal' | 'form' | 'dialog' | 'inline' | 'panel';
+    /** Whether the effect supports streaming output. */
+    streaming?: boolean;
+    /** Whether user confirmation is required before execution. */
+    requiresConfirmation?: boolean;
+    /** Icon suggestion for the UI. */
+    icon?: string;
+}
+export interface EffectInteractionPattern {
+    kind: string;
+    inputSchema: SchemaField[];
+    outputSchema: SchemaField[];
+    renderHints: RenderHints;
+}
+export interface EffectLike {
+    kind: string;
+    [key: string]: unknown;
+}
+export declare const BUILT_IN_PATTERNS: readonly EffectInteractionPattern[];
+/**
+ * Find the interaction pattern for a given effect.
+ */
+export declare function getPatternForEffect(effect: EffectLike): EffectInteractionPattern | undefined;
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate input data against a pattern's input schema.
+ */
+export declare function validateEffectInput(pattern: EffectInteractionPattern, input: Record<string, unknown>): ValidationResult;
+/**
+ * Format a human-readable summary of an effect result.
+ */
+export declare function formatEffectSummary(pattern: EffectInteractionPattern, result: Record<string, unknown>): string;
+//# sourceMappingURL=typedEffectPatterns.d.ts.map

package/dist/interaction/typedEffectPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedEffectPatterns.d.ts","sourceRoot":"","sources":["../../src/interaction/typedEffectPatterns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5D,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,eAAO,MAAM,iBAAiB,EAAE,SAAS,wBAAwB,EAuFhE,CAAC;AAMF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,wBAAwB,GAAG,SAAS,CAE5F;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,gBAAgB,CAyBlB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CA0CR"}