Automations
162
Get Current Time
Return the current date and time.
Calculator
Evaluate mathematical expressions with basic arithmetic operations.
Generate Character Variant
Generate 1 new character image variant with strong character consistency using a reference Starships image attachment (from agentSlug or attachmentId) + a prompt, via google/gemini-3-pro-image-preview. Supports optional output dimensions via size (e.g., "1024x1024") or explicit width/height.
Read Older Messages
Read older conversation history beyond the agent prompt window. `offset` skips that many most recent messages (tail offset), then returns the next `limit` older messages (chronological order).
Search Connector
Search connector templates (catalog) by query and return a ranked list of matching connectors (supports limit; empty query returns a lightweight listing).
Search Connector
Search connector templates (catalog) by query and return a ranked list of matching connectors (supports limit; empty query returns a lightweight listing).
Suggest Connectors
Suggest one or more connector providers by rendering connector cards inline in chat (via render_widget). Creates or reuses a saved widget with a deterministic slug.
Suggest Agents
Suggest 2–3 marketplace agents by rendering agent cards inline in chat (via render_widget). Creates or reuses a saved widget with a deterministic slug.
Render Starship Details
Render an inline widget showing starship details (name, description, website URL) and allowing updates. Creates or reuses a saved widget with a deterministic slug and emits render_widget.
Search Widgets
Search saved widgets for the current starship by name/slug/widgetType. Returns matching widget records (including widgetType + props). Does not render anything.
Render Widget
Render an existing saved widget by slug in the conversation UI by emitting a ui_action (render_widget). Looks up the widget for the current STARSHIP_ID and renders it.
List Agents From Marketplace
Search and list agent templates available in the marketplace for discovery and deployment. Supports search by name, description, or capabilities. Returns a lean array (id, slug, name, description, category, role) without heavy fields like systemPrompt or blueprint.
Deploy Agents From Marketplace
Deploy an agent template from the marketplace onto this starship. Creates a new agent instance from a template slug.
Call Agent
Delegate a message to another agent by slug using a linked child conversation (create a new child or continue an existing childConversationId). Returns the child conversation/message result.
Update Widget
Update an existing widget by id with partial changes (props are merged, not replaced; optional name/description). Returns the updated widget record.
Create Widget
Create (persist) a widget given a widgetType + props. Always include name + description; returns the created widget record.
List Connectors
List connectors available/configured for the current starship. Returns a lean array (provider, status, authType, scopes, actions). Useful before building tools that rely on third-party services.
Modify Tool Blueprint Edge
Add, edit, or remove a blueprint edge in an existing tool by slug using a single interface (op=add/edit/remove). Returns { ok: true } on success, or validation errors.