diff --git a/internal/generated/admin/catalog.go b/internal/generated/admin/catalog.go index d455fbb..962cc12 100644 --- a/internal/generated/admin/catalog.go +++ b/internal/generated/admin/catalog.go @@ -4924,7 +4924,8 @@ func Catalog() []resourcecmd.ResourceSpec { {Name: "machine-id", Target: "path.machineId", Required: true, Description: "machine id"}, }, Flags: []resourcecmd.FlagSpec{ - {Name: "ports", Type: resourcecmd.FlagStringSlice, Target: "body.ports", Usage: "The ports the token grants access to, or \"*\" for all ports", Required: true, Repeated: true}, + {Name: "ports", Type: resourcecmd.FlagJSON, Target: "body.ports", Usage: "The ports the token grants access to, or \"*\" for all ports", Required: true, Repeated: false}, + {Name: "ports-file", Type: resourcecmd.FlagJSONFile, Target: "body.ports", Usage: "Read ports JSON from a file", Required: false, Repeated: false}, {Name: "ttl-seconds", Type: resourcecmd.FlagFloat, Target: "body.ttl_seconds", Usage: "How long the token stays valid, in seconds", Required: false, Repeated: false}, }, }, @@ -5667,7 +5668,7 @@ func Catalog() []resourcecmd.ResourceSpec { Plural: "chat", Singular: "chat", Short: "Chat", - Long: "Chat links providers such as Slack and Microsoft Teams to your instance. Manage chat connections and chat instances, and read their workspaces and events.", + Long: "Chat links providers such as Slack and Microsoft Teams to your instance. Manage chat connections, chat instances and their provider, read workspaces and events, and read and send messages in connected chats.", Operations: []resourcecmd.OperationSpec{}, Children: []resourcecmd.ResourceSpec{ { @@ -5825,6 +5826,17 @@ func Catalog() []resourcecmd.ResourceSpec { {Name: "updated-at", Type: resourcecmd.FlagJSON, Target: "query.updated_at", Usage: "Filter chat instance last update time by date range", Required: false, Repeated: false}, }, }, + { + Name: "sync", + Method: "POST", + Path: "/chat/instances/:chatInstanceId/sync", + Short: "Sync chat instance", + Long: "Triggers a sync of the workspaces available on this chat instance.", + SDKMapping: "chat.instances.sync", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-instance-id", Target: "path.chatInstanceId", Required: true, Description: "chat instance id"}, + }, + }, { Name: "update", Method: "PATCH", @@ -5845,6 +5857,55 @@ func Catalog() []resourcecmd.ResourceSpec { }, }, }, + Children: []resourcecmd.ResourceSpec{ + { + Plural: "provider", + Singular: "provider", + Short: "Chat instance provider", + Long: "Chat instances materialize a chat connection for a specific runtime configuration.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "authenticated-user", + Method: "GET", + Path: "/chat/instances/:chatInstanceId/provider/authenticated-user", + Short: "Get chat instance authenticated user", + Long: "Retrieves the chat provider account this chat instance is authenticated as.", + SDKMapping: "chat.instances.provider.authenticatedUser", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-instance-id", Target: "path.chatInstanceId", Required: true, Description: "chat instance id"}, + }, + }, + { + Name: "get", + Method: "GET", + Path: "/chat/instances/:chatInstanceId/provider", + Short: "Get chat instance provider", + Long: "Retrieves the single provider configured for a chat instance.", + SDKMapping: "chat.instances.provider.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-instance-id", Target: "path.chatInstanceId", Required: true, Description: "chat instance id"}, + }, + }, + { + Name: "set", + Method: "PATCH", + Path: "/chat/instances/:chatInstanceId/provider", + Short: "Set chat instance provider", + Long: "Creates or updates the single provider for a chat instance.", + SDKMapping: "chat.instances.provider.set", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-instance-id", Target: "path.chatInstanceId", Required: true, Description: "chat instance id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "provider-id", Type: resourcecmd.FlagString, Target: "body.provider_id", Usage: "The chat provider to use for this instance", Required: true, Repeated: false}, + {Name: "provider-deployment-id", Type: resourcecmd.FlagString, Target: "body.provider_deployment_id", Usage: "Provider deployment to use", Required: false, Repeated: false}, + {Name: "provider-config-id", Type: resourcecmd.FlagString, Target: "body.provider_config_id", Usage: "Provider config to use", Required: false, Repeated: false, Nullable: true}, + {Name: "provider-auth-config-id", Type: resourcecmd.FlagString, Target: "body.provider_auth_config_id", Usage: "Provider auth config to use", Required: false, Repeated: false, Nullable: true}, + }, + }, + }, + }, + }, }, { Plural: "workspaces", @@ -5925,6 +5986,423 @@ func Catalog() []resourcecmd.ResourceSpec { }, }, }, + { + Plural: "chats", + Singular: "chats", + Short: "Chats", + Long: "A chat represents a single connected chat surface, such as a Slack or Microsoft Teams tenant, running on a chat instance.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/chats/:chatId", + Short: "Get chat", + Long: "Retrieves a specific chat.", + SDKMapping: "chats.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats", + Short: "List chats", + Long: "Returns a paginated list of chats.", + SDKMapping: "chats.list", + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "search", Type: resourcecmd.FlagString, Target: "query.search", Usage: "Search by name", Required: false, Repeated: false}, + {Name: "status", Type: resourcecmd.FlagStringSlice, Target: "query.status", Usage: "Filter by status", Required: false, Repeated: true}, + {Name: "id", Type: resourcecmd.FlagStringSlice, Target: "query.id", Usage: "Filter by chat ID(s)", Required: false, Repeated: true}, + {Name: "chat-connection-id", Type: resourcecmd.FlagStringSlice, Target: "query.chat_connection_id", Usage: "Filter by chat connection ID(s)", Required: false, Repeated: true}, + {Name: "chat-instance-id", Type: resourcecmd.FlagStringSlice, Target: "query.chat_instance_id", Usage: "Filter by chat instance ID(s)", Required: false, Repeated: true}, + {Name: "chat-instance-provider-id", Type: resourcecmd.FlagStringSlice, Target: "query.chat_instance_provider_id", Usage: "Filter by chat instance provider ID(s)", Required: false, Repeated: true}, + {Name: "created-at", Type: resourcecmd.FlagJSON, Target: "query.created_at", Usage: "Filter chat creation time by date range", Required: false, Repeated: false}, + {Name: "updated-at", Type: resourcecmd.FlagJSON, Target: "query.updated_at", Usage: "Filter chat last update time by date range", Required: false, Repeated: false}, + }, + }, + }, + }, + { + Plural: "channels", + Singular: "channels", + Short: "Chat Channels", + Long: "Chat channels are the conversations within a chat, such as Slack channels or Microsoft Teams channels.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/chats/:chatId/channels/:channelId", + Short: "Get chat channel", + Long: "Retrieves a specific chat channel.", + SDKMapping: "chats.channels.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "channel-id", Target: "path.channelId", Required: true, Description: "channel id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats/:chatId/channels", + Short: "List chat channels", + Long: "Returns a paginated list of channels for a chat.", + SDKMapping: "chats.channels.list", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "workspace-id", Type: resourcecmd.FlagString, Target: "query.workspace_id", Usage: "Filter to channels in this workspace", Required: false, Repeated: false}, + {Name: "type", Type: resourcecmd.FlagString, Target: "query.type", Usage: "Filter by channel type", Required: false, Repeated: false}, + {Name: "search", Type: resourcecmd.FlagString, Target: "query.search", Usage: "Search by channel name or topic", Required: false, Repeated: false}, + {Name: "has-access", Type: resourcecmd.FlagBool, Target: "query.has_access", Usage: "Whether to return channels the chat integration can or cannot access; defaults to true", Required: false, Repeated: false}, + }, + }, + }, + Children: []resourcecmd.ResourceSpec{ + { + Plural: "members", + Singular: "members", + Short: "Chat Channels", + Long: "Chat channels are the conversations within a chat, such as Slack channels or Microsoft Teams channels.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/chats/:chatId/channels/:channelId/members/:userId", + Short: "Get chat channel member", + Long: "Retrieves a specific member of a chat channel.", + SDKMapping: "chats.channels.members.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "channel-id", Target: "path.channelId", Required: true, Description: "channel id"}, + {Name: "user-id", Target: "path.userId", Required: true, Description: "user id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats/:chatId/channels/:channelId/members", + Short: "List chat channel members", + Long: "Returns a paginated list of members of a chat channel.", + SDKMapping: "chats.channels.members.list", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "channel-id", Target: "path.channelId", Required: true, Description: "channel id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + }, + }, + }, + }, + { + Plural: "typing", + Singular: "typing", + Short: "Chat typing indicator", + Long: "Chat channels are the conversations within a chat, such as Slack channels or Microsoft Teams channels.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "start", + Method: "POST", + Path: "/chats/:chatId/channels/:channelId/typing", + Short: "Start chat typing indicator", + Long: "Shows a typing indicator in a chat channel.", + SDKMapping: "chats.channels.typing.start", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "channel-id", Target: "path.channelId", Required: true, Description: "channel id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "thread-id", Type: resourcecmd.FlagString, Target: "body.thread_id", Usage: "Show the typing indicator within this thread", Required: false, Repeated: false}, + {Name: "status", Type: resourcecmd.FlagString, Target: "body.status", Usage: "Provider-specific typing status text", Required: false, Repeated: false}, + }, + }, + }, + }, + }, + }, + { + Plural: "threads", + Singular: "threads", + Short: "Chat Threads", + Long: "Chat threads group replies to a message within a chat channel.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/chats/:chatId/threads/:threadId", + Short: "Get chat thread", + Long: "Retrieves a specific chat thread.", + SDKMapping: "chats.threads.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "thread-id", Target: "path.threadId", Required: true, Description: "thread id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel this thread belongs to", Required: false, Repeated: false}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats/:chatId/threads", + Short: "List chat threads", + Long: "Returns a paginated list of threads in a chat channel.", + SDKMapping: "chats.threads.list", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel to list threads for", Required: false, Repeated: false}, + {Name: "type", Type: resourcecmd.FlagString, Target: "query.type", Usage: "Filter by thread type", Required: false, Repeated: false}, + }, + }, + }, + }, + { + Plural: "messages", + Singular: "messages", + Short: "Chat Messages", + Long: "Chat messages are the individual messages sent within a chat channel.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "create", + Method: "POST", + Path: "/chats/:chatId/messages", + Short: "Send chat message", + Long: "Sends a new message to a chat channel.", + SDKMapping: "chats.messages.create", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "body.channel_id", Usage: "The channel to send the message to", Required: true, Repeated: false}, + {Name: "thread-id", Type: resourcecmd.FlagString, Target: "body.thread_id", Usage: "Send the message within this thread", Required: false, Repeated: false}, + {Name: "parts", Type: resourcecmd.FlagJSON, Target: "body.parts", Usage: "Structured content parts making up the message body", Required: true, Repeated: false}, + {Name: "parts-file", Type: resourcecmd.FlagJSONFile, Target: "body.parts", Usage: "Read parts JSON from a file", Required: false, Repeated: false}, + {Name: "alt-text", Type: resourcecmd.FlagString, Target: "body.alt_text", Usage: "Plain-text fallback for the message", Required: false, Repeated: false}, + {Name: "attachments", Type: resourcecmd.FlagJSON, Target: "body.attachments", Usage: "attachments", Required: false, Repeated: false}, + {Name: "attachments-file", Type: resourcecmd.FlagJSONFile, Target: "body.attachments", Usage: "Read attachments JSON from a file", Required: false, Repeated: false}, + {Name: "reply-message-id", Type: resourcecmd.FlagString, Target: "body.reply_message_id", Usage: "Reply to this message", Required: false, Repeated: false}, + {Name: "ephemeral-target-user-id", Type: resourcecmd.FlagString, Target: "body.ephemeral_target_user_id", Usage: "Send this message so only this user can see it", Required: false, Repeated: false}, + }, + }, + { + Name: "delete", + Method: "DELETE", + Path: "/chats/:chatId/messages/:messageId", + Short: "Delete chat message", + Long: "Deletes a specific chat message.", + SDKMapping: "chats.messages.delete", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel this message belongs to", Required: false, Repeated: false}, + }, + }, + { + Name: "get", + Method: "GET", + Path: "/chats/:chatId/messages/:messageId", + Short: "Get chat message", + Long: "Retrieves a specific chat message.", + SDKMapping: "chats.messages.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel this message belongs to", Required: false, Repeated: false}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats/:chatId/messages", + Short: "List chat messages", + Long: "Returns a paginated list of messages in a chat channel.", + SDKMapping: "chats.messages.list", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel to list messages for", Required: false, Repeated: false}, + {Name: "thread-id", Type: resourcecmd.FlagString, Target: "query.thread_id", Usage: "Filter to messages in this thread", Required: false, Repeated: false}, + {Name: "search", Type: resourcecmd.FlagString, Target: "query.search", Usage: "Search message content", Required: false, Repeated: false}, + }, + }, + { + Name: "read", + Method: "POST", + Path: "/chats/:chatId/messages/:messageId/read", + Short: "Mark chat message read", + Long: "Marks a specific chat message as read.", + SDKMapping: "chats.messages.read", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "body.channel_id", Usage: "The channel this message belongs to", Required: true, Repeated: false}, + {Name: "thread-id", Type: resourcecmd.FlagString, Target: "body.thread_id", Usage: "The thread this message belongs to", Required: false, Repeated: false}, + }, + }, + { + Name: "update", + Method: "PATCH", + Path: "/chats/:chatId/messages/:messageId", + Short: "Edit chat message", + Long: "Edits a specific chat message.", + SDKMapping: "chats.messages.update", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "body.channel_id", Usage: "The channel this message belongs to", Required: true, Repeated: false}, + {Name: "parts", Type: resourcecmd.FlagJSON, Target: "body.parts", Usage: "Structured content parts making up the message body", Required: true, Repeated: false}, + {Name: "parts-file", Type: resourcecmd.FlagJSONFile, Target: "body.parts", Usage: "Read parts JSON from a file", Required: false, Repeated: false}, + {Name: "alt-text", Type: resourcecmd.FlagString, Target: "body.alt_text", Usage: "Plain-text fallback for the message", Required: false, Repeated: false}, + }, + }, + }, + Children: []resourcecmd.ResourceSpec{ + { + Plural: "reactions", + Singular: "reactions", + Short: "Chat Messages", + Long: "Chat messages are the individual messages sent within a chat channel.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "create", + Method: "POST", + Path: "/chats/:chatId/messages/:messageId/reactions", + Short: "Add chat message reaction", + Long: "Adds a reaction to a specific chat message.", + SDKMapping: "chats.messages.reactions.create", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "body.channel_id", Usage: "The channel this message belongs to", Required: true, Repeated: false}, + {Name: "emoji", Type: resourcecmd.FlagString, Target: "body.emoji", Usage: "emoji", Required: true, Repeated: false}, + }, + }, + { + Name: "delete", + Method: "DELETE", + Path: "/chats/:chatId/messages/:messageId/reactions", + Short: "Remove chat message reaction", + Long: "Removes a reaction from a specific chat message.", + SDKMapping: "chats.messages.reactions.delete", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel this message belongs to", Required: false, Repeated: false}, + {Name: "emoji", Type: resourcecmd.FlagString, Target: "query.emoji", Usage: "The unicode emoji shortcode to remove", Required: false, Repeated: false}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/chats/:chatId/messages/:messageId/reactions", + Short: "List chat message reactions", + Long: "Returns the reactions left on a specific chat message.", + SDKMapping: "chats.messages.reactions.list", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + {Name: "message-id", Target: "path.messageId", Required: true, Description: "message id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "channel-id", Type: resourcecmd.FlagString, Target: "query.channel_id", Usage: "The channel this message belongs to", Required: false, Repeated: false}, + }, + }, + }, + }, + }, + }, + { + Plural: "dms", + Singular: "dms", + Short: "Chat direct messages", + Long: "Open direct message channels with one or more users on a chat.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "open", + Method: "POST", + Path: "/chats/:chatId/dms", + Short: "Open chat DM", + Long: "Opens (or retrieves) a direct message channel with one or more users.", + SDKMapping: "chats.dms.open", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "type", Type: resourcecmd.FlagString, Target: "body.type", Usage: "type", Required: false, Repeated: false}, + {Name: "user", Type: resourcecmd.FlagJSON, Target: "body.user", Usage: "user", Required: false, Repeated: false}, + {Name: "user-file", Type: resourcecmd.FlagJSONFile, Target: "body.user", Usage: "Read user JSON from a file", Required: false, Repeated: false}, + {Name: "users", Type: resourcecmd.FlagJSON, Target: "body.users", Usage: "users", Required: false, Repeated: false}, + {Name: "users-file", Type: resourcecmd.FlagJSONFile, Target: "body.users", Usage: "Read users JSON from a file", Required: false, Repeated: false}, + }, + }, + }, + }, + { + Plural: "commands", + Singular: "commands", + Short: "Chat slash command responses", + Long: "Chat messages are the individual messages sent within a chat channel.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "respond", + Method: "POST", + Path: "/chats/:chatId/commands/respond", + Short: "Respond to chat command", + Long: "Replies to a slash command from a chat.command.invoked event, using the provider's native command response.", + SDKMapping: "chats.commands.respond", + Args: []resourcecmd.ArgumentSpec{ + {Name: "chat-id", Target: "path.chatId", Required: true, Description: "chat id"}, + }, + Flags: []resourcecmd.FlagSpec{ + {Name: "chat-event-id", Type: resourcecmd.FlagString, Target: "body.chat_event_id", Usage: "The chat.command.invoked event to respond to. Providers only accept a response within their response window after the command was invoked.", Required: true, Repeated: false}, + {Name: "parts", Type: resourcecmd.FlagJSON, Target: "body.parts", Usage: "Structured content parts making up the message body", Required: true, Repeated: false}, + {Name: "parts-file", Type: resourcecmd.FlagJSONFile, Target: "body.parts", Usage: "Read parts JSON from a file", Required: false, Repeated: false}, + {Name: "alt-text", Type: resourcecmd.FlagString, Target: "body.alt_text", Usage: "Plain-text fallback for the response", Required: false, Repeated: false}, + {Name: "ephemeral", Type: resourcecmd.FlagBool, Target: "body.ephemeral", Usage: "If true, only the user who invoked the command can see the response. Defaults to the provider behavior. Providers that already acknowledged the command publicly reject it.", Required: false, Repeated: false}, + }, + }, + }, + }, }, }, { @@ -6318,6 +6796,128 @@ func Catalog() []resourcecmd.ResourceSpec { }, }, }, + { + Plural: "deliveries", + Singular: "deliveries", + Short: "Event deliveries", + Long: "An event delivery is Metorial's record of sending one event to one event destination, including every attempt it took to get there.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/organization/event-deliveries/:eventDeliveryId", + Short: "Get event delivery", + Long: "Get a specific event delivery recorded for the organization", + SDKMapping: "eventDeliveries.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "event-delivery-id", Target: "path.eventDeliveryId", Required: true, Description: "event delivery id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/organization/event-deliveries", + Short: "List event deliveries", + Long: "List event deliveries recorded for the organization", + SDKMapping: "eventDeliveries.list", + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "status", Type: resourcecmd.FlagStringSlice, Target: "query.status", Usage: "Filter by delivery status", Required: false, Repeated: true}, + {Name: "event-id", Type: resourcecmd.FlagStringSlice, Target: "query.event_id", Usage: "Filter by the event being delivered", Required: false, Repeated: true}, + {Name: "event-type", Type: resourcecmd.FlagStringSlice, Target: "query.event_type", Usage: "Filter by the type of the event being delivered", Required: false, Repeated: true}, + {Name: "event-destination-id", Type: resourcecmd.FlagStringSlice, Target: "query.event_destination_id", Usage: "Filter by the event destination being delivered to", Required: false, Repeated: true}, + {Name: "instance-id", Type: resourcecmd.FlagStringSlice, Target: "query.instance_id", Usage: "Filter by the instance the delivered event occurred in", Required: false, Repeated: true}, + }, + }, + { + Name: "retry", + Method: "POST", + Path: "/organization/event-deliveries/:eventDeliveryId/retry", + Short: "Retry event delivery", + Long: "Schedules another attempt for a delivery that has finished, whether it succeeded or gave up. The delivery is given a fresh attempt budget.", + SDKMapping: "eventDeliveries.retry", + Args: []resourcecmd.ArgumentSpec{ + {Name: "event-delivery-id", Target: "path.eventDeliveryId", Required: true, Description: "event delivery id"}, + }, + }, + }, + }, + { + Plural: "delivery-attempts", + Singular: "delivery-attempts", + Short: "Event delivery attempts", + Long: "A delivery attempt is one request Metorial made to an event destination, with the request it sent and the response it got back.", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/organization/event-delivery-attempts/:eventDeliveryAttemptId", + Short: "Get event delivery attempt", + Long: "Get a specific delivery attempt, including the request Metorial sent and the response the destination returned", + SDKMapping: "eventDeliveryAttempts.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "event-delivery-attempt-id", Target: "path.eventDeliveryAttemptId", Required: true, Description: "event delivery attempt id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/organization/event-delivery-attempts", + Short: "List event delivery attempts", + Long: "List delivery attempts recorded for the organization", + SDKMapping: "eventDeliveryAttempts.list", + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + {Name: "status", Type: resourcecmd.FlagStringSlice, Target: "query.status", Usage: "Filter by attempt outcome", Required: false, Repeated: true}, + {Name: "event-delivery-id", Type: resourcecmd.FlagStringSlice, Target: "query.event_delivery_id", Usage: "Filter by the delivery the attempts belong to", Required: false, Repeated: true}, + {Name: "event-id", Type: resourcecmd.FlagStringSlice, Target: "query.event_id", Usage: "Filter by the event being delivered", Required: false, Repeated: true}, + {Name: "event-destination-id", Type: resourcecmd.FlagStringSlice, Target: "query.event_destination_id", Usage: "Filter by the event destination being delivered to", Required: false, Repeated: true}, + }, + }, + }, + }, + }, + }, + { + Plural: "audit-logs", + Singular: "audit-logs", + Short: "Audit log", + Long: "Read organization audit logs", + Operations: []resourcecmd.OperationSpec{ + { + Name: "get", + Method: "GET", + Path: "/organization/audit-logs/:auditLogId", + Short: "Get organization audit log", + Long: "Get a specific audit log recorded for the organization", + SDKMapping: "audit_logs.get", + Args: []resourcecmd.ArgumentSpec{ + {Name: "audit-log-id", Target: "path.auditLogId", Required: true, Description: "audit log id"}, + }, + }, + { + Name: "list", + Method: "GET", + Path: "/organization/audit-logs", + Short: "List organization audit logs", + Long: "List audit logs recorded for the organization", + SDKMapping: "audit_logs.list", + Flags: []resourcecmd.FlagSpec{ + {Name: "limit", Type: resourcecmd.FlagFloat, Target: "query.limit", Usage: "limit", Required: false, Repeated: false}, + {Name: "after", Type: resourcecmd.FlagString, Target: "query.after", Usage: "after", Required: false, Repeated: false}, + {Name: "before", Type: resourcecmd.FlagString, Target: "query.before", Usage: "before", Required: false, Repeated: false}, + {Name: "cursor", Type: resourcecmd.FlagString, Target: "query.cursor", Usage: "cursor", Required: false, Repeated: false}, + {Name: "order", Type: resourcecmd.FlagString, Target: "query.order", Usage: "order", Required: false, Repeated: false}, + }, + }, }, }, { @@ -6641,7 +7241,7 @@ func Catalog() []resourcecmd.ResourceSpec { Plural: "monitoring", Singular: "monitoring", Short: "Monitoring", - Long: "Monitoring tracks automated checks on your instance. Read monitors and ProtoGuard prompt-injection settings, and review and resolve alerts for detected prompt-injection or schema-change events.", + Long: "Monitoring tracks automated checks on your instance. Read monitors, and review and resolve alerts for detected prompt-injection or schema-change events.", Operations: []resourcecmd.OperationSpec{}, Children: []resourcecmd.ResourceSpec{ { diff --git a/manifest/admin.yaml b/manifest/admin.yaml index ff70333..3b3d4dd 100644 --- a/manifest/admin.yaml +++ b/manifest/admin.yaml @@ -272,6 +272,9 @@ commands: - path: [sandbox, machines, access] resource: sandbox.machines.access short: Sandbox machine access + args: + ports: + ports: { flag: ports, type: json } - path: [sandbox, machines, instances] resource: sandbox.machines.instances @@ -322,14 +325,18 @@ commands: - path: [chat] group: true short: Chat - long: Chat links providers such as Slack and Microsoft Teams to your instance. Manage chat connections and chat instances, and read their workspaces and events. + long: Chat links providers such as Slack and Microsoft Teams to your instance. Manage chat connections, chat instances and their provider, read workspaces and events, and read and send messages in connected chats. - path: [chat, connections] resource: chat.connections - path: [chat, instances] resource: chat.instances - include: [list, get, create, update, delete] + include: [list, get, create, update, delete, sync] + + - path: [chat, instances, provider] + resource: chat.instances.provider + short: Chat instance provider - path: [chat, workspaces] resource: chat.workspaces @@ -337,6 +344,44 @@ commands: - path: [chat, events] resource: chat.events + - path: [chat, chats] + resource: chats + + - path: [chat, channels] + resource: chats.channels + + - path: [chat, channels, members] + resource: chats.channels.members + + - path: [chat, channels, typing] + resource: chats.channels.typing + short: Chat typing indicator + + - path: [chat, threads] + resource: chats.threads + + - path: [chat, messages] + resource: chats.messages + + - path: [chat, messages, reactions] + resource: chats.messages.reactions + args: + create: + emoji: { flag: emoji, type: string } + + - path: [chat, dms] + resource: chats.dms + short: Chat direct messages + args: + open: + type: { flag: type, type: string } + user: { flag: user, type: json } + users: { flag: users, type: json } + + - path: [chat, commands] + resource: chats.commands + short: Chat slash command responses + - path: [callbacks] resource: callbacks @@ -356,6 +401,15 @@ commands: resource: eventDestinationListeners include: [list, get, create, delete] + - path: [events, deliveries] + resource: eventDeliveries + + - path: [events, delivery-attempts] + resource: eventDeliveryAttempts + + - path: [audit-logs] + resource: audit_logs + - path: [network] group: true short: Network Access @@ -379,7 +433,7 @@ commands: - path: [monitoring] group: true short: Monitoring - long: Monitoring tracks automated checks on your instance. Read monitors and ProtoGuard prompt-injection settings, and review and resolve alerts for detected prompt-injection or schema-change events. + long: Monitoring tracks automated checks on your instance. Read monitors, and review and resolve alerts for detected prompt-injection or schema-change events. - path: [monitoring, monitors] resource: monitors