@getfrontline/cli 1.0.3 → 1.0.5

package/dist/skills/relations/SKILL.md

@@ -34,7 +34,7 @@ frontline object field create <source-obj> --data '{
 Before working with relations, inspect the object schema to find relation names:
 
 ```bash
-frontline object schema standard__people
+frontline object schema people
 ```
 
 The output includes a `relations` array:
@@ -44,11 +44,11 @@ The output includes a `relations` array:
     "relations": [
         {
             "name": "company",
-            "target": "standard__companies",
+            "target": "companies",
             "mode": "multi",
             "display_field": "Name"
         },
-        { "name": "deals", "target": "standard__deals", "mode": "multi", "display_field": "Name" }
+        { "name": "deals", "target": "deals", "mode": "multi", "display_field": "Name" }
     ]
 }
 ```
@@ -65,7 +65,7 @@ frontline object relation link <object> <source-id> <relation> <target-id>
 
 ```bash
 # Link a person to a company
-frontline object relation link standard__people 6625abc123def456 Companies 6625def789abc012
+frontline object relation link people 6625abc123def456 Companies 6625def789abc012
 ```
 
 - **Idempotent**: linking the same target twice won't create duplicates.
@@ -81,7 +81,7 @@ frontline object relation unlink <object> <source-id> <relation> <target-id>
 
 ```bash
 # Remove person from company
-frontline object relation unlink standard__people 6625abc123def456 Companies 6625def789abc012
+frontline object relation unlink people 6625abc123def456 Companies 6625def789abc012
 ```
 
 ## Get Related Records (Forward Lookup)
@@ -94,7 +94,7 @@ frontline object relation get <object> <source-id> <relation>
 
 ```bash
 # Get all companies linked to this person
-frontline object relation get standard__people 6625abc123def456 Companies
+frontline object relation get people 6625abc123def456 Companies
 ```
 
 Returns an array of related records with their full data.
@@ -109,10 +109,10 @@ frontline object relation find-by <object> <relation> <target-id> [--page N] [--
 
 ```bash
 # Find all people linked to a specific company
-frontline object relation find-by standard__people Companies 6625def789abc012
+frontline object relation find-by people Companies 6625def789abc012
 
 # With pagination
-frontline object relation find-by standard__people Companies 6625def789abc012 --page 1 --page-size 20
+frontline object relation find-by people Companies 6625def789abc012 --page 1 --page-size 20
 ```
 
 Returns a paginated result: `{ rows, total_count, total_pages, current_page }`.
@@ -121,23 +121,23 @@ Returns a paginated result: `{ rows, total_count, total_pages, current_page }`.
 
 ```bash
 # 1. Show current company links
-frontline object relation get standard__people <person-id> Companies
+frontline object relation get people <person-id> Companies
 
 # 2. Unlink from old company
-frontline object relation unlink standard__people <person-id> Companies <old-company-id>
+frontline object relation unlink people <person-id> Companies <old-company-id>
 
 # 3. Link to new company
-frontline object relation link standard__people <person-id> Companies <new-company-id>
+frontline object relation link people <person-id> Companies <new-company-id>
 
 # 4. Verify
-frontline object relation get standard__people <person-id> Companies
+frontline object relation get people <person-id> Companies
 ```
 
 ## Workflow: Find All Deals for a Company
 
 ```bash
 # Find deals linked to a company (reverse: deals that point to this company)
-frontline object relation find-by standard__deals Company <company-id>
+frontline object relation find-by deals Company <company-id>
 ```
 
 ## Filtering by Relation
@@ -147,10 +147,10 @@ You can also filter records by relations using the query system
 
 ```bash
 # Find people with no company
-frontline object record list standard__people --query '{"path": "[Company]", "operator": "isNull"}'
+frontline object record list people --query '{"path": "[Company]", "operator": "isNull"}'
 
 # Find people linked to specific companies
-frontline object record list standard__people --query '{
+frontline object record list people --query '{
   "path": "[Company]",
   "operator": "containsAny",
   "value": ["6625def789abc012", "6625def789abc999"]

package/dist/skills/resource-creation/SKILL.md

@@ -20,11 +20,13 @@ This skill covers the creation of top-level entities: **Tables** and **Objects**
 ## Creating a Table
 
 To create a new data table, use `frontline table create`. You MUST provide at least one column in the `--data` payload.
+Tables use **emoji characters** for their icon.
 
 ```bash
 frontline table create <name> --data '{
   "displayName": "Display Name",
   "emoji": "📁",
+  "icon_color": "blue",
   "columns": [
     { "name": "Name", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -36,6 +38,8 @@ frontline table create <name> --data '{
 ```bash
 frontline table create shipments --data '{
   "displayName": "Shipments",
+  "emoji": "🚚",
+  "icon_color": "orange",
   "columns": [
     { "name": "Cargo", "type": "string", "metadata": { "format": "text" } },
     { "name": "Weight", "type": "number", "metadata": { "format": "decimal", "decimals": 2 } }
@@ -46,11 +50,13 @@ frontline table create shipments --data '{
 ## Creating a Custom Object
 
 To create a new custom object, use `frontline object create`. This creates a more robust entity that supports multiple record types.
+Objects use **icon keys** (not emoji characters) for their icon — see the Available Icons section below.
 
 ```bash
 frontline object create <name> --data '{
   "displayName": "Display Name",
-  "emoji": "🎫",
+  "emoji": "ticket",
+  "icon_color": "amber",
   "columns": [
     { "name": "Subject", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -62,6 +68,8 @@ frontline object create <name> --data '{
 ```bash
 frontline object create tickets --data '{
   "displayName": "Support Tickets",
+  "emoji": "life-buoy",
+  "icon_color": "amber",
   "columns": [
     { "name": "Title", "type": "string", "metadata": { "format": "text" } },
     { "name": "Priority", "type": "select", "metadata": { "mode": "singleSelect" } }
@@ -74,6 +82,67 @@ frontline object create tickets --data '{
 1.  **Name (slug)**: Lowercase, alphanumeric, and underscores only. E.g., `sales_leads`, `shipments_v2`.
 2.  **Display Name**: Readable text with spaces. E.g., `Sales Leads`, `Shipments V2`.
 
+## Available Icons (Objects only)
+
+Objects use the `emoji` field with a validated icon key. Tables use regular emoji characters instead.
+
+Use the `emoji` field to set an object's icon. The value must be one of the valid icon keys:
+
+`home`, `user`, `users`, `contact-book`, `building`, `building-2`, `briefcase`, `agreement`,
+`handshake`, `legal-doc`, `legal-hammer`, `shopping`, `cart`, `store`, `invoice`, `credit-card`,
+`coins`, `wallet`, `money-bag`, `ticket`, `life-buoy`, `support`, `headset`, `task`, `clipboard`,
+`file`, `folder`, `book`, `book-open`, `bookmark`, `mail`, `call`, `chat`, `calendar`, `clock`,
+`timer`, `hourglass`, `location`, `maps`, `globe`, `earth`, `link`, `tag`, `flag`, `chart`,
+`pie-chart`, `target`, `megaphone`, `rocket`, `idea`, `magnet`, `star`, `award`, `medal`,
+`badge`, `certificate`, `crown`, `diamond`, `gift`, `percent`, `heart`, `hospital`, `stethoscope`,
+`shield`, `lock`, `key`, `fingerprint`, `umbrella`, `settings`, `edit`, `wrench`, `code`, `puzzle`,
+`database`, `layers`, `hierarchy`, `pipeline`, `package`, `truck`, `car`, `bicycle`, `bus`,
+`property`, `school`, `graduate`, `plant`, `leaf`, `fire`, `sun`, `moon`, `image`, `video`,
+`music`, `mic`, `camera`, `paint`, `compass`, `anchor`, `zap`, `flash`, `notification`, `user-add`,
+`repeat`, `cloud`, `wifi`, `printer`, `airplane`, `restaurant`, `coffee`, `phone`, `analytics`,
+`pulse`, `contracts`, `delivery`, `receipt`, `qr-code`, `barcode`, `calculator`, `download`, `upload`,
+`filter`, `search`, `view`, `share`, `archive`, `dumbbell`, `brain`, `atom`, `chip`, `robot`,
+`satellite`, `factory`, `warehouse`, `mountain`, `tree`, `flower`, `drone`, `gamepad`, `safe`,
+`label`, `stamp`, `thumbs-up`, `smile`, `recycle`, `laptop`, `tv`, `headphones`, `speaker`,
+`alarm`, `glasses`, `flashlight`, `feather`, `id-card`, `loyalty`, `coupon`, `presentation`,
+`ruler`, `highlighter`, `passport`, `bitcoin`, `fuel`, `luggage`, `bone`, `whistle`, `sofa`
+
+## Available Icon Colors
+
+Use the `icon_color` field to set the icon color. You can use a **color name** (case-insensitive) or a **hex code**:
+
+| Name    | Hex       |
+| ------- | --------- |
+| red     | `#f87171` |
+| orange  | `#fb923c` |
+| amber   | `#fbbf24` |
+| yellow  | `#facc15` |
+| lime    | `#a3e635` |
+| green   | `#4ade80` |
+| emerald | `#34d399` |
+| teal    | `#2dd4bf` |
+| cyan    | `#22d3ee` |
+| sky     | `#38bdf8` |
+| blue    | `#60a5fa` |
+| indigo  | `#818cf8` |
+| violet  | `#a78bfa` |
+| purple  | `#c084fc` |
+| pink    | `#f472b6` |
+| rose    | `#fb7185` |
+
+## Record Type Icons
+
+Record types on objects also support `emoji` and `icon_color`. If omitted, they inherit from the default record type or the parent object.
+
+```bash
+frontline object record-type create deals --data '{
+  "name": "renewal",
+  "displayName": "Renewal",
+  "emoji": "repeat",
+  "icon_color": "teal"
+}'
+```
+
 ## Adding More Fields
 
 Once the entity is created, you can add more fields using the `field create` subcommand:

package/dist/skills/schema-design/SKILL.md

@@ -21,15 +21,22 @@ Frontline CLI. Read this before creating or modifying fields on any table or obj
 | **Object** | Business entities, record types, pipeln | `object create` |
 
 ```bash
-# Example: Create a new custom object
+# Example: Create a new custom object (with icon and color)
 frontline object create <name> --data '{
   "displayName": "My Object",
+  "emoji": "briefcase",
+  "icon_color": "blue",
   "columns": [
     { "name": "Title", "type": "string", "metadata": { "format": "text" } }
   ]
 }'
 ```
 
+> **Note:** Objects use icon keys (e.g. `briefcase`, `rocket`, `chart`) for the `emoji` field.
+> Tables use regular emoji characters (e.g. `📁`, `🚚`) instead.
+> Both support `icon_color` with a color name.
+> See the `resource-creation` skill for the full icon and color reference.
+
 ## Field Type Decision Tree
 
 ```
@@ -174,17 +181,17 @@ frontline object option create <obj> <field-id> --data '{ "name": "Low", "color"
 A single-select field with ordered stages:
 
 ```bash
-frontline object field create standard__deals --data '{
+frontline object field create deals --data '{
   "name": "Stage",
   "type": "select",
   "metadata": { "mode": "singleSelect" }
 }'
 # Then add stages in order:
-frontline object option create standard__deals <field-id> --data '{"name": "Lead", "color": "Gray"}'
-frontline object option create standard__deals <field-id> --data '{"name": "Qualified", "color": "Sky"}'
-frontline object option create standard__deals <field-id> --data '{"name": "Proposal", "color": "Amber"}'
-frontline object option create standard__deals <field-id> --data '{"name": "Won", "color": "Emerald"}'
-frontline object option create standard__deals <field-id> --data '{"name": "Lost", "color": "Red"}'
+frontline object option create deals <field-id> --data '{"name": "Lead", "color": "Gray"}'
+frontline object option create deals <field-id> --data '{"name": "Qualified", "color": "Sky"}'
+frontline object option create deals <field-id> --data '{"name": "Proposal", "color": "Amber"}'
+frontline object option create deals <field-id> --data '{"name": "Won", "color": "Emerald"}'
+frontline object option create deals <field-id> --data '{"name": "Lost", "color": "Red"}'
 ```
 
 ### 2. Contact Info Set
@@ -236,28 +243,28 @@ Field names are **display names** shown in the UI. Use natural, readable names.
 
 ```bash
 # 1. Check what fields already exist
-frontline object field list standard__companies
+frontline object field list companies
 
 # 2. Check schema for relations
-frontline object schema standard__companies
+frontline object schema companies
 
 # 3. Add new fields — only add what's missing
-frontline object field create standard__companies --data '{
+frontline object field create companies --data '{
   "name": "Annual Revenue",
   "type": "number",
   "metadata": { "format": "currency", "currency": "USD", "decimals": 0 }
 }'
 
 # 4. Add a categorization field
-frontline object field create standard__companies --data '{
+frontline object field create companies --data '{
   "name": "Industry",
   "type": "select",
   "metadata": { "mode": "singleSelect" }
 }'
 # Add options
-frontline object option create standard__companies <field-id> --data '{"name":"Technology","color":"Sky"}'
-frontline object option create standard__companies <field-id> --data '{"name":"Finance","color":"Amber"}'
+frontline object option create companies <field-id> --data '{"name":"Technology","color":"Sky"}'
+frontline object option create companies <field-id> --data '{"name":"Finance","color":"Amber"}'
 
 # 5. Verify the final schema
-frontline object field list standard__companies
+frontline object field list companies
 ```

package/dist/skills/tools/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: tools
+description: Create, list, inspect, update, delete, and assign Frontline API call tools from the CLI. Use when the user asks about tools, custom tools, API tools, headers, arguments, query params, or assigning tools to agents.
+---
+
+## Prerequisites
+
+- Authenticate with `frontline auth login <api-key>`.
+- Creating, updating, and deleting tools requires a USER API key.
+- This public surface supports `API_CALL` tools only. WhatsApp template tools are not exposed yet.
+
+## List And Inspect
+
+```bash
+frontline tools list
+frontline tools list --status ACTIVE --filter-text contact
+frontline tools list --table
+frontline tools describe <toolId>
+```
+
+Tool list output includes `id`, `name`, `status`, `method`, `url`, and timestamps.
+
+## Create An API Tool
+
+```bash
+frontline tools create \
+  --name "Fetch contact" \
+  --description "Fetches a CRM contact" \
+  --method GET \
+  --url "https://api.example.com/contacts/{{contactId}}" \
+  --arguments '[{"name":"contactId","description":"CRM contact ID","dataType":"STRING"}]' \
+  --headers '[{"key":"Authorization","value":"Bearer {{apiKey}}"}]' \
+  --query-params '[{"key":"include","value":"deals"}]'
+```
+
+Complex options are JSON arrays:
+
+- `--arguments`: `[{ "name": "...", "description": "...", "dataType": "STRING" }]`
+- `--headers`: `[{ "key": "...", "value": "..." }]`
+- `--query-params`: `[{ "key": "...", "value": "..." }]`
+
+Supported argument data types are `STRING`, `NUMBER`, `DECIMAL`, and `BOOLEAN`.
+Supported methods are `GET`, `POST`, `PUT`, `PATCH`, and `DELETE`.
+
+## Update And Delete
+
+```bash
+frontline tools update <toolId> --status PAUSED
+frontline tools update <toolId> --url "https://api.example.com/v2/contacts/{{contactId}}"
+frontline tools update <toolId> --headers '[{"key":"Authorization","value":"Bearer {{apiKey}}"}]'
+frontline tools delete <toolId>
+```
+
+Update replaces `arguments`, `headers`, or `queryParams` when those options are
+provided. Delete is a soft delete.
+
+## Assign To An Agent
+
+Use `customToolIds` in the agent setting payload:
+
+```bash
+frontline agents agent-setting update --data '{"customToolIds":[123],"instructions":"Use the contact tool when a user asks about CRM data.","temperature":0.2,"aiModelId":1}'
+```
+
+The API validates that assigned tool IDs belong to the same account.

package/dist/skills/variables/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: variables
+description: Manage Frontline agent variables, workflow variables, and flow intents from the CLI, and explain variable interpolation in nodes and actions.
+allowed-tools: Bash(frontline:*)
+---
+
+# Variables And Intents
+
+## Agent Variables
+
+```bash
+frontline agents use <agentId>
+frontline agents variables list --table
+frontline agents variables all
+frontline agents variables create --name customer_name --description "Customer name"
+frontline agents variables describe 123
+frontline agents variables update 123 --name customer_name --pattern "^[A-Za-z ]+$"
+frontline agents variables delete 123
+frontline agents variables check-name customer_name
+```
+
+Use `--agent-id <id>` to avoid relying on saved context.
+
+## Agent Intents
+
+```bash
+frontline agents intents list --table
+frontline agents intents all
+frontline agents intents create --name cancellation --phrases '["cancel order","stop subscription"]'
+frontline agents intents update 10 --name cancellation --phrases '[{"id":1,"phrase":"cancel order"},{"phrase":"stop order"}]'
+frontline agents intents delete 10
+frontline agents intents generate-phrases --name cancellation --samples '["cancel order"]' --amount 5
+```
+
+For create, `--phrases` is a JSON array of strings. For update, `--phrases` is a
+JSON array of objects; existing phrases include `id`, and new phrases omit it.
+
+## Workflow Variables
+
+```bash
+frontline workflows use <workflowId>
+frontline workflows variables list --table
+frontline workflows variables all
+frontline workflows variables create --name order_id --description "Order ID"
+frontline workflows variables describe 123
+frontline workflows variables update 123 --name order_id --pattern "^[0-9]+$"
+frontline workflows variables delete 123
+frontline workflows variables check-name order_id
+```
+
+Use `--workflow-id <id>` to avoid relying on saved context.
+
+## Interpolation Syntax
+
+Variables are referenced inside text fields as `{VARIABLE_NAME}`. The name must
+match `variable.name` exactly. Automation workflows also expose each node output
+as a runtime variable named after the node ID. Because node IDs follow the
+`node_<uuid>` format, a node with `nodeId`
+`node_a1b2c3d4-e5f6-7890-abcd-ef1234567890` is referenced downstream as
+`{node_a1b2c3d4-e5f6-7890-abcd-ef1234567890}`.
+
+Agent flow fields with variable replacement:
+
+- API: `url`, `headers[].value`, `parameters[].value`, `body`.
+- Say AI: `message`, `prompt`.
+- Response AI: `instructions`.
+- Tools AI: `instructions`.
+- Conditional Routing AI: `conditions[].expression`.
+- Dynamic Tables: `rowId`, `search`, `rowData` values.
+
+Automation workflow fields with variable replacement:
+
+- API: `url`, `headers[].value`, `parameters[].value`, `body`.
+- Send Message / Say AI: `message`, `prompt`.
+- Response AI: `instructions`.
+- Tools AI: `instructions`, `prompt`.
+- AI Capture: `prompt`, `instructions`.
+- Data Transformer: `prompt`.
+- Conditional Routing AI: `conditions[].expression`.
+- Dynamic Tables: `rowId`, `search`, `rowData` values.
+- Transcription: `audioUrl`.
+- WhatsApp Template: `templateVariables.header`, `templateVariables.body`, `templateVariables.buttons`.