agent-inbox

Agent Inbox Skill

List and manage user feedback items from the agent inbox.

When to Use

Use this skill when the user:

• Asks about feedback, bug reports, or feature requests
• Wants to check their agent inbox
• Asks you to review or manage inbox items
• Wants to acknowledge, dismiss, or mark feedback as implemented

When NOT to Use

• To automatically check the inbox without the user asking
• To auto-implement feedback (present items to the user instead)
• For general project task management (use project tasks instead)

Available Functions

listAgentInboxItems(statusFilter, topicFilter)

List inbox items with optional filters. Checks if the agent inbox is enabled first.

Parameters:

• statusFilter (list[str], optional): Filter by status
• topicFilter (list[str], optional): Filter by topic

Status values: "PENDING", "ACKNOWLEDGED", "DISMISSED", "IMPLEMENTED", "DELETED"

Topic values: "BUG_REPORT", "FEATURE_REQUEST", "DESIGN", "CONTENT", "OTHER"

Returns: Dict with:

• items: List of inbox items
• totalCount: Total number of matching items

Each item contains:

• id: Unique item identifier
• replId: The repl this item belongs to
• status: Current status
• topic: Item topic/category
• feedbackText: The feedback content
• currentPage: Page the feedback was submitted from
• screenshots: List of screenshot URLs
• timeCreated: ISO timestamp
• timeUpdated: ISO timestamp

Example:

// List all pending items
const result = await listAgentInboxItems({ statusFilter: ["PENDING"] });
for (const item of result.items) {
    console.log(`[${item.topic}] ${item.feedbackText}`);
}

// List bug reports
const result = await listAgentInboxItems({ topicFilter: ["BUG_REPORT"] });
for (const item of result.items) {
    console.log(`[${item.topic}] ${item.feedbackText}`);
}

updateAgentInboxItem(itemId, status)

Update the status of an inbox item.

Parameters:

• itemId (str, required): The item ID to update
• status (str, required): New status to set

Status values: "PENDING", "ACKNOWLEDGED", "DISMISSED", "IMPLEMENTED", "DELETED"

Returns: Dict with the updated item fields (same shape as items in list response).

Example:

// Acknowledge an item after reviewing it
const result = await updateAgentInboxItem({ itemId: "abc123", status: "ACKNOWLEDGED" });
console.log(`Updated: ${result.id} -> ${result.status}`);

Item Topics

• BUG_REPORT: Bug reports from users
• FEATURE_REQUEST: Feature requests
• DESIGN: Design feedback
• CONTENT: Content-related feedback
• OTHER: Other feedback

Item Statuses

• PENDING: New, unprocessed item
• ACKNOWLEDGED: Item has been seen and noted
• DISMISSED: Item was dismissed
• IMPLEMENTED: Feedback has been implemented
• DELETED: Item was deleted

Example Workflow

// 1. List pending inbox items
const result = await listAgentInboxItems({ statusFilter: ["PENDING"] });
console.log(`Found ${result.totalCount} pending items`);

// 2. Review each item and acknowledge
for (const item of result.items) {
    console.log(`[${item.topic}] ${item.feedbackText}`);
    await updateAgentInboxItem({ itemId: item.id, status: "ACKNOWLEDGED" });
}

Error Handling

• Inbox not enabled: Raises RuntimeError if the agent inbox is not enabled for the repl
• Invalid status: Raises ValueError for unrecognized status strings
• Invalid topic: Raises ValueError for unrecognized topic strings