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