feedbackbasket-cli 0.8.0 → 0.9.1

package/README.md

@@ -93,7 +93,9 @@ feedbackbasket feedback create "Title" --content "Body" --project myapp
 feedbackbasket feedback create "Login bug" --content "Clicking Log in does nothing" --project myapp --type bug --page-url https://example.com/login
 feedbackbasket feedback update <id> --status PLANNED       # Update status
 feedbackbasket feedback update <id> --category BUG         # Update category
-feedbackbasket feedback reply <id> "Thanks for reporting!" # Email the submitter
+feedbackbasket feedback reply <id> "Thanks!" --delivery email --reply-to support@example.com
+feedbackbasket feedback reply <id> "Thanks!" --delivery widget
+feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com
 feedbackbasket feedback replies <id>                       # List sent replies
 feedbackbasket feedback note <id> "Investigating this..."  # Add internal note
 feedbackbasket feedback delete <id>                        # Delete feedback
@@ -139,6 +141,16 @@ feedbackbasket widget flow myapp --config ./feedback-flow.json
 feedbackbasket widget script myapp
 ```
 
+For inline trigger mode, load the widget once and call the public API from your own button:
+
+```html
+<button onclick="window.FeedbackWidget.openFeedbackForm({ trigger: event.currentTarget })">
+  Feedback
+</button>
+```
+
+Passing the trigger element lets popup mode open beside your custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
+
 Use `--email-read-only` and `--hide-email-when-prefilled` with runtime `userEmail` values from your app. These settings do not store visitor emails in FeedbackBasket widget settings.
 
 `widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. V1 supports guided mode with `text`, `textarea`, and `single_choice` follow-up questions.

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
 export declare class FeedbackBasketClient {
     private http;
     constructor(token: string, baseUrl: string);
@@ -61,16 +61,10 @@ export declare class FeedbackBasketClient {
         content: string;
         createdAt: string;
     }>;
-    sendReply(feedbackId: string, content: string, replyToEmail?: string): Promise<{
-        reply: {
-            id: string;
-            content: string;
-            replyToEmail: string;
-            sentBy: string;
-            createdAt: string;
-        };
-        sentTo: string;
-    }>;
+    sendReply(feedbackId: string, content: string, opts?: {
+        replyToEmail?: string;
+        destinations?: Array<'email' | 'widget'>;
+    }): Promise<FeedbackReplyResponse>;
     listReplies(feedbackId: string): Promise<{
         replies: Array<{
             id: string;
@@ -79,6 +73,7 @@ export declare class FeedbackBasketClient {
             sentBy: string;
             createdAt: string;
         }>;
+        messages?: NonNullable<FeedbackReplyResponse['message']>[];
         total: number;
     }>;
     deleteFeedback(id: string): Promise<{

package/dist/src/client.js

@@ -70,8 +70,11 @@ export class FeedbackBasketClient {
     async createNote(feedbackId, content) {
         return this.request('POST', `/feedback/${encodeURIComponent(feedbackId)}/notes`, { content });
     }
-    async sendReply(feedbackId, content, replyToEmail) {
+    async sendReply(feedbackId, content, opts = {}) {
         const body = { content };
+        if (opts.destinations)
+            body.destinations = opts.destinations;
+        const replyToEmail = opts.replyToEmail;
         if (replyToEmail)
             body['replyToEmail'] = replyToEmail;
         return this.request('POST', `/feedback/${encodeURIComponent(feedbackId)}/replies`, body);

package/dist/src/commands/feedback-reply.js

@@ -4,79 +4,84 @@ import { AuthManager } from '../auth/manager.js';
 import { loadConfig } from '../config/config.js';
 import { errAuth, errUsage } from '../output/errors.js';
 import { brand } from '../output/theme.js';
-import { ask, confirm } from '../prompt.js';
+import { ask } from '../prompt.js';
+const deliveryOptions = new Set(['email', 'widget', 'both']);
 export function createFeedbackReplyCommand(getWriter) {
     return new Command('reply')
         .argument('<id>', 'Feedback ID to reply to')
         .argument('[content]', 'Reply content (or use --content)')
-        .description('Send an email reply to the feedback submitter')
+        .description('Reply to feedback by email, widget thread, or both')
         .option('--content <text>', 'Reply content (alternative to positional argument)')
-        .option('--reply-to <email>', 'Reply-to email (overrides project default)')
+        .option('--delivery <delivery>', 'Reply delivery (email, widget, both)', 'email')
+        .option('--reply-to <email>', 'Reply-to email for email delivery')
         .action(async (id, contentArg, opts) => {
         const writer = getWriter();
         const content = contentArg ?? opts.content;
+        const delivery = opts.delivery;
         if (!content) {
-            throw errUsage('Reply content is required', 'Example: feedbackbasket feedback reply <id> "Thanks for reporting this!"');
+            throw errUsage('Reply content is required', 'Example: feedbackbasket feedback reply <id> "Thanks for reporting this!" --delivery widget');
+        }
+        if (!deliveryOptions.has(delivery)) {
+            throw errUsage('Delivery must be email, widget, or both', 'Example: feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com');
         }
         const client = requireClient();
-        let replyTo = opts.replyTo;
-        // If no --reply-to flag, check if we need to resolve one interactively
-        if (!replyTo) {
-            const feedback = await client.getFeedbackById(id);
+        const feedback = await client.getFeedbackById(id);
+        const destinations = delivery === 'both'
+            ? ['email', 'widget']
+            : [delivery];
+        const sendsEmail = destinations.includes('email');
+        const sendsWidget = destinations.includes('widget');
+        let replyTo = opts.replyTo ?? feedback.project.replyToEmail ?? undefined;
+        if (sendsEmail) {
             if (!feedback.email) {
-                throw errUsage('This feedback has no email address — cannot send a reply.');
+                throw errUsage('This feedback has no email address; use --delivery widget if it has a widget thread.');
             }
-            const projectReplyTo = feedback.project.replyToEmail;
-            if (!projectReplyTo) {
+            if (!replyTo) {
                 const isInteractive = !writer.isMachineOutput() && process.stdin.isTTY;
-                if (isInteractive) {
-                    // Get user's email as suggestion
-                    const manager = new AuthManager();
-                    const creds = manager.getCredentials();
-                    const accountEmail = creds?.email;
-                    console.log();
-                    console.log(brand.warning('  No reply-to email configured for this project.'));
-                    console.log(brand.muted('  The recipient will see this as the sender address.'));
-                    console.log();
-                    if (accountEmail) {
-                        const useAccount = await confirm(`  Use ${brand.bold(accountEmail)}?`);
-                        if (useAccount) {
-                            replyTo = accountEmail;
-                        }
-                        else {
-                            replyTo = await ask('  Enter reply-to email: ');
-                            if (!replyTo || !replyTo.includes('@')) {
-                                console.log(brand.muted('  Cancelled.'));
-                                return;
-                            }
-                        }
-                    }
-                    else {
-                        replyTo = await ask('  Enter reply-to email: ');
-                        if (!replyTo || !replyTo.includes('@')) {
-                            console.log(brand.muted('  Cancelled.'));
-                            return;
-                        }
-                    }
-                    console.log();
-                    console.log(brand.muted(`  Tip: Set a default with: feedbackbasket projects update ${feedback.project.name} --reply-to ${replyTo}`));
-                    console.log();
+                if (!isInteractive) {
+                    throw errUsage('No reply-to email configured for this project.', 'Ask the human which reply-to email to use, then pass --reply-to <email> or set a project default.');
                 }
-                else {
-                    // Agent mode — must pass --reply-to or set project default
-                    throw errUsage('No reply-to email configured for this project.', `Pass --reply-to <email> or set a default: feedbackbasket projects update <project> --reply-to <email>`);
+                console.log();
+                console.log(brand.warning('  No reply-to email configured for this project.'));
+                console.log(brand.muted('  The recipient will see this as the sender address.'));
+                console.log();
+                replyTo = await ask('  Enter reply-to email: ');
+                if (!replyTo || !replyTo.includes('@')) {
+                    console.log(brand.muted('  Cancelled.'));
+                    return;
                 }
+                console.log();
+                console.log(brand.muted(`  Tip: Set a default with: feedbackbasket projects update ${feedback.project.name} --reply-to ${replyTo}`));
+                console.log();
             }
         }
-        const result = await client.sendReply(id, content, replyTo);
+        if (sendsWidget && !feedback.hasWidgetAccess) {
+            throw errUsage('This feedback is not connected to a widget thread.', 'Use --delivery email for feedback with an email address, or ask the human how they want to respond.');
+        }
+        const result = await client.sendReply(id, content, {
+            replyToEmail: replyTo,
+            destinations,
+        });
         if (!writer.isMachineOutput()) {
-            console.log(`  ${brand.success('✓')} Reply sent to ${brand.bold(result.sentTo)}`);
-            console.log(`    ${brand.muted('From:')} ${result.reply.replyToEmail}`);
-            console.log(`    ${brand.muted('By:')}   ${result.reply.sentBy}`);
+            if (result.sentTo) {
+                console.log(`  ${brand.success('[OK]')} Email reply sent to ${brand.bold(result.sentTo)}`);
+                if (result.reply) {
+                    console.log(`    ${brand.muted('From:')} ${result.reply.replyToEmail}`);
+                    console.log(`    ${brand.muted('By:')}   ${result.reply.sentBy}`);
+                }
+            }
+            if (result.message) {
+                console.log(`  ${brand.success('[OK]')} Widget reply posted`);
+                console.log(`    ${brand.muted('By:')}   ${result.message.sentByName ?? 'CLI'}`);
+            }
             console.log();
         }
         writer.ok(result, {
-            summary: `Reply sent to ${result.sentTo}`,
+            summary: delivery === 'both'
+                ? 'Reply sent by email and widget'
+                : delivery === 'widget'
+                    ? 'Widget reply posted'
+                    : `Reply sent to ${result.sentTo}`,
             breadcrumbs: [
                 { action: 'View replies', cmd: `feedbackbasket feedback replies ${id}` },
                 { action: 'Update status', cmd: `feedbackbasket feedback update ${id} --status COMPLETE` },
@@ -93,8 +98,10 @@ export function createFeedbackRepliesCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const result = await client.listReplies(id);
+        const messages = result.messages ?? [];
+        const visibleWidgetMessages = messages.filter((item) => !item.replyId);
         if (!writer.isMachineOutput()) {
-            if (result.replies.length === 0) {
+            if (result.total === 0) {
                 console.log(brand.muted('  No replies sent yet.'));
                 console.log();
             }
@@ -102,7 +109,8 @@ export function createFeedbackRepliesCommand(getWriter) {
                 console.log(brand.bold(`${result.total} repl${result.total === 1 ? 'y' : 'ies'} for feedback ${id}`));
                 console.log();
                 for (const r of result.replies) {
-                    console.log(`  ${brand.success('→')} ${brand.bold(r.sentBy)} ${brand.muted(r.createdAt)}`);
+                    console.log(`  ${brand.success('->')} ${brand.bold(r.sentBy)} ${brand.muted(r.createdAt)}`);
+                    console.log(`    ${brand.muted('Delivery:')} email`);
                     console.log(`    ${brand.muted('Reply-to:')} ${r.replyToEmail}`);
                     console.log();
                     for (const line of r.content.split('\n')) {
@@ -110,12 +118,22 @@ export function createFeedbackRepliesCommand(getWriter) {
                     }
                     console.log();
                 }
+                for (const message of visibleWidgetMessages) {
+                    console.log(`  ${brand.success('->')} ${brand.bold(message.sentByName ?? 'CLI')} ${brand.muted(message.createdAt)}`);
+                    console.log(`    ${brand.muted('Delivery:')} widget`);
+                    console.log();
+                    for (const line of message.content.split('\n')) {
+                        console.log(`    ${line}`);
+                    }
+                    console.log();
+                }
             }
         }
-        writer.ok(result.replies, {
+        writer.ok({ replies: result.replies, messages }, {
             summary: `${result.total} repl${result.total === 1 ? 'y' : 'ies'}`,
             breadcrumbs: [
-                { action: 'Send a reply', cmd: `feedbackbasket feedback reply ${id} "<content>"` },
+                { action: 'Send an email reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery email` },
+                { action: 'Post a widget reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery widget` },
                 { action: 'View feedback', cmd: `feedbackbasket feedback show ${id}` },
             ],
         });

package/dist/src/commands/feedback.js

@@ -186,6 +186,7 @@ function renderFeedbackDetail(item) {
         ['OS', item.os],
         ['Device', item.device],
         ['Language', item.language],
+        ['Widget Thread', item.hasWidgetAccess ? 'Yes' : null],
         ['Created', item.createdAt],
     ];
     for (const [label, value] of fields) {

package/dist/src/commands/widget.js

@@ -243,6 +243,7 @@ export function createWidgetCommand(getWriter) {
         const projectId = await resolveProjectId(client, projectArg);
         const result = await client.getWidgetScript(projectId);
         if (!writer.isMachineOutput()) {
+            const settingsResult = await client.getWidgetSettings(projectId);
             console.log(brand.bold(`Widget embed code for ${result.projectName}`));
             console.log(divider(50));
             console.log();
@@ -252,6 +253,7 @@ export function createWidgetCommand(getWriter) {
             console.log();
             console.log(brand.muted(`  Script URL: ${result.scriptUrl}`));
             console.log();
+            renderInlineTriggerHelp(settingsResult.settings);
         }
         writer.ok(result, {
             summary: `Embed code for "${result.projectName}"`,
@@ -341,6 +343,27 @@ function isRecord(value) {
 function stringValue(value) {
     return typeof value === 'string' ? value.trim() : '';
 }
+function renderInlineTriggerHelp(settings) {
+    if (settings.triggerMode !== 'inline')
+        return;
+    console.log(brand.bold('Custom inline trigger'));
+    console.log(divider(50));
+    console.log();
+    console.log(brand.muted('  Call this from your own button:'));
+    console.log();
+    console.log(`  ${brand.primary('<button onclick="window.FeedbackWidget.openFeedbackForm({ trigger: event.currentTarget })">')}`);
+    console.log(`  ${brand.primary('  Feedback')}`);
+    console.log(`  ${brand.primary('</button>')}`);
+    console.log();
+    if (settings.displayMode === 'popup') {
+        console.log(brand.muted('  Passing the trigger keeps popup mode anchored beside your custom button.'));
+    }
+    else {
+        console.log(brand.muted('  Modal mode stays centered; passing the trigger is safe for future popup changes.'));
+    }
+    console.log(brand.muted('  Existing calls to window.FeedbackWidget.openFeedbackForm() still work.'));
+    console.log();
+}
 function renderWidgetSettings(projectName, settings) {
     console.log(brand.bold(`Widget settings — ${projectName}`));
     console.log(divider(40));

package/dist/src/types.d.ts

@@ -2,6 +2,7 @@ export type FeedbackStatus = 'OPEN' | 'UNDER_REVIEW' | 'PLANNED' | 'IN_PROGRESS'
 export type FeedbackCategory = 'BUG' | 'FEATURE_REQUEST' | 'IMPROVEMENT' | 'QUESTION';
 export type Sentiment = 'POSITIVE' | 'NEGATIVE' | 'NEUTRAL';
 export type Severity = 'high' | 'medium' | 'low';
+export type ReplyDelivery = 'email' | 'widget' | 'both';
 export type FeedbackFlowQuestionType = 'text' | 'textarea' | 'single_choice';
 export interface FeedbackFlowQuestion {
     id: string;
@@ -84,6 +85,7 @@ export interface Feedback {
     os?: string | null;
     device?: string | null;
     language?: string | null;
+    hasWidgetAccess?: boolean;
     attachments?: FeedbackAttachment[];
     project: {
         id: string;
@@ -141,6 +143,25 @@ export interface FeedbackCreateResponse {
     url: string;
     feedback: Feedback;
 }
+export interface FeedbackReplyResponse {
+    reply: {
+        id: string;
+        content: string;
+        replyToEmail: string;
+        sentBy: string;
+        createdAt: string;
+    } | null;
+    message: {
+        id: string;
+        content: string;
+        delivery: 'WIDGET' | 'EMAIL' | 'BOTH';
+        sentByName: string | null;
+        replyId: string | null;
+        createdAt: string;
+    } | null;
+    sentTo: string | null;
+    destinations: Array<'email' | 'widget'>;
+}
 export interface BugReportsResponse {
     bugReports: BugReport[];
     stats: {

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.8.0";
-export declare const USER_AGENT = "FeedbackBasket-CLI/0.8.0";
+export declare const VERSION = "0.9.1";
+export declare const USER_AGENT = "FeedbackBasket-CLI/0.9.1";

package/dist/src/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.8.0';
+export const VERSION = '0.9.1';
 export const USER_AGENT = `FeedbackBasket-CLI/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Command-line interface for FeedbackBasket — manage feedback from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",

package/skills/feedbackbasket/SKILL.md

@@ -69,9 +69,10 @@ feedbackbasket feedback note <id> "Investigating — appears related to auth flo
 feedbackbasket feedback delete <id> --yes
 feedbackbasket feedback bulk-update --status CLOSED --ids id1,id2,id3
 
-# Reply to submitter via email
-feedbackbasket feedback reply <id> "Thanks for reporting — we pushed a fix!"
-feedbackbasket feedback reply <id> "<content>" --reply-to vlad@example.com  # override reply-to
+# Reply to submitter by email, widget thread, or both
+feedbackbasket feedback reply <id> "Thanks for reporting — we pushed a fix!" --delivery email --reply-to support@example.com
+feedbackbasket feedback reply <id> "<content>" --delivery widget
+feedbackbasket feedback reply <id> "<content>" --delivery both --reply-to support@example.com
 feedbackbasket feedback replies <id>                                          # list past replies
 
 # Export
@@ -108,6 +109,24 @@ feedbackbasket widget flow <project> --reset-default --enable
 feedbackbasket widget flow <project> --config ./feedback-flow.json
 ```
 
+For inline trigger mode, load the widget once and call the public API from the host app's custom button:
+
+```html
+<button onclick="window.FeedbackWidget.openFeedbackForm({ trigger: event.currentTarget })">
+  Feedback
+</button>
+```
+
+In React:
+
+```tsx
+<button onClick={(event) => window.FeedbackWidget.openFeedbackForm({ trigger: event.currentTarget })}>
+  Feedback
+</button>
+```
+
+Passing the trigger element lets popup mode open beside the custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
+
 `email-read-only` and `hide-email-when-prefilled` control behavior only when the host app passes a runtime `userEmail` value. Do not store visitor emails in widget settings.
 
 `widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. Use it when an agent needs to customize visitor choices such as Bug report, Feature request, and General feedback. Supported v1 question types are `text`, `textarea`, and `single_choice`.
@@ -166,18 +185,22 @@ feedbackbasket feedback show <id> --agent
 
 ### Close the loop — reply to the submitter
 ```bash
-# Agent reads context, drafts its own reply, sends it
-feedbackbasket feedback show <id> --agent                    # read context + project.replyToEmail
-feedbackbasket feedback reply <id> "<drafted response>" --agent
+# Agent reads context, asks which delivery method to use, then sends it
+feedbackbasket feedback show <id> --agent                    # read email, hasWidgetAccess, project.replyToEmail
+feedbackbasket feedback reply <id> "<drafted response>" --delivery widget --agent
+feedbackbasket feedback reply <id> "<drafted response>" --delivery email --reply-to support@example.com --agent
+feedbackbasket feedback reply <id> "<drafted response>" --delivery both --reply-to support@example.com --agent
 feedbackbasket feedback update <id> --status COMPLETE --agent
 feedbackbasket feedback note <id> "Replied via CLI" --agent
 ```
-**Important:** If `feedback show` returns `project.replyToEmail: null`, the agent MUST either:
-1. Pass `--reply-to <email>` with an explicit address, OR
-2. Ask the human which reply-to email to use (the account owner's email is a reasonable default, but requires user confirmation), OR
-3. Set a project default first: `feedbackbasket projects update <project> --reply-to <email>`
-
-Never silently guess a reply-to address — it becomes the "From" address the customer sees.
+**Important reply safety rules:**
+- Before replying, the agent MUST inspect `feedback show --agent`, then ask the human which delivery method to use: `email`, `widget`, or `both`, unless the human already specified it in the current conversation.
+- If `feedback show` returns `email: null`, do not use `--delivery email` or `--delivery both`. If `hasWidgetAccess: true`, use `--delivery widget`; otherwise ask the human how they want to respond.
+- If `hasWidgetAccess: false`, do not use `--delivery widget` or `--delivery both`.
+- If the delivery includes email and `project.replyToEmail: null`, the agent MUST ask the human which reply-to email to use before sending. Do not use the account owner's email, token owner's email, or any remembered address without explicit confirmation in the current conversation.
+- After the human confirms a reply-to address, pass it explicitly with `--reply-to <email>`, or set a project default first with `feedbackbasket projects update <project> --reply-to <email>`.
+
+Never silently guess a reply-to address. It becomes the "From" address the customer sees.
 
 ### Export for analysis
 ```bash