@getfrontline/cli 1.0.3 → 1.0.5

package/dist/skills/crm-setup/SKILL.md

@@ -24,7 +24,7 @@ allowed-tools: Bash(frontline:*)
 This skill walks through building a complete CRM system: Companies, Contacts,
 and Deals — with relations, pipeline stages, record types, and views.
 
-> The built-in `standard__companies`, `standard__people`, and `standard__deals` objects already
+> The built-in `companies`, `people`, and `deals` objects already
 > exist. This guide uses **custom objects** to show how to build everything from
 > scratch, but the same patterns apply when extending existing objects.
 
@@ -75,6 +75,8 @@ Use `object create` for business entities and `table create` for simple data.
 # Create a new "Embarques" table
 frontline table create embarques --data '{
   "displayName": "Embarques",
+  "emoji": "truck",
+  "icon_color": "orange",
   "columns": [
     { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -83,6 +85,8 @@ frontline table create embarques --data '{
 # Create a new "Pedidos" table
 frontline table create pedidos --data '{
   "displayName": "Pedidos",
+  "emoji": "package",
+  "icon_color": "blue",
   "columns": [
     { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -92,9 +96,9 @@ frontline table create pedidos --data '{
 The system also ships with these core objects:
 
 ```
-standard__companies  — Companies
-standard__people     — People (contacts)
-standard__deals      — Deals (sales pipeline)
+companies  — Companies
+people     — People (contacts)
+deals      — Deals (sales pipeline)
 ```
 
 Verify they exist:
@@ -103,21 +107,35 @@ Verify they exist:
 frontline object list
 ```
 
+### Setting Icons on Existing Objects/Tables
+
+```bash
+frontline object update deals --data '{"emoji": "handshake", "icon_color": "emerald"}'
+frontline table update embarques --data '{"emoji": "delivery", "icon_color": "teal"}'
+```
+
+### Available Icon Colors
+
+Use the `icon_color` field with a **color name** (case-insensitive):
+
+`red`, `orange`, `amber`, `yellow`, `lime`, `green`, `emerald`, `teal`,
+`cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`, `pink`, `rose`
+
 ## Step 2 — Inspect & Extend the Schema
 
 ### View current fields
 
 ```bash
-frontline object field list standard__companies
-frontline object field list standard__people
-frontline object field list standard__deals
+frontline object field list companies
+frontline object field list people
+frontline object field list deals
 ```
 
 ### Add custom fields
 
 ```bash
 # Add a "Lead Source" select field to People
-frontline object field create standard__people --data '{
+frontline object field create people --data '{
   "name": "Lead Source",
   "type": "select",
   "metadata": { "mode": "singleSelect" }
@@ -125,20 +143,20 @@ frontline object field create standard__people --data '{
 # → Returns: { id: 15, name: "Lead Source", type: "select", ... }
 
 # Add options to the new field (use the field ID from above)
-frontline object option create standard__people 15 --data '{"name": "Website", "color": "Sky"}'
-frontline object option create standard__people 15 --data '{"name": "Referral", "color": "Emerald"}'
-frontline object option create standard__people 15 --data '{"name": "Cold Outreach", "color": "Gray"}'
-frontline object option create standard__people 15 --data '{"name": "Event", "color": "Lavender"}'
+frontline object option create people 15 --data '{"name": "Website", "color": "Sky"}'
+frontline object option create people 15 --data '{"name": "Referral", "color": "Emerald"}'
+frontline object option create people 15 --data '{"name": "Cold Outreach", "color": "Gray"}'
+frontline object option create people 15 --data '{"name": "Event", "color": "Lavender"}'
 
 # Add a "Probability %" number field to Deals
-frontline object field create standard__deals --data '{
+frontline object field create deals --data '{
   "name": "Probability",
   "type": "number",
   "metadata": {}
 }'
 
 # Add a "Next Follow-up" date field to Deals
-frontline object field create standard__deals --data '{
+frontline object field create deals --data '{
   "name": "Next Follow-up",
   "type": "dateOnly",
   "metadata": {}
@@ -150,13 +168,13 @@ frontline object field create standard__deals --data '{
 The built-in objects already have relations defined:
 
 ```bash
-frontline object schema standard__people
-# → relations: [{ name: "companies", target: "standard__companies", mode: "multi" }]
+frontline object schema people
+# → relations: [{ name: "companies", target: "companies", mode: "multi" }]
 
-frontline object schema standard__deals
+frontline object schema deals
 # → relations: [
-#     { name: "people", target: "standard__people", mode: "multi" },
-#     { name: "company", target: "standard__companies", mode: "single" }
+#     { name: "people", target: "people", mode: "multi" },
+#     { name: "company", target: "companies", mode: "single" }
 #   ]
 ```
 
@@ -167,14 +185,14 @@ The `name` field is what you use in all relation commands.
 ### Create companies
 
 ```bash
-frontline object record create standard__companies --data '{
+frontline object record create companies --data '{
   "Name": "Acme Corp",
   "Domain": "acme.com",
   "Primary Location": "New York, USA"
 }'
 # → { id: "6625aaa...", ... }
 
-frontline object record create standard__companies --data '{
+frontline object record create companies --data '{
   "Name": "TechStart Inc",
   "Domain": "techstart.io",
   "Primary Location": "San Francisco, USA"
@@ -185,7 +203,7 @@ frontline object record create standard__companies --data '{
 ### Create contacts
 
 ```bash
-frontline object record create standard__people --data '{
+frontline object record create people --data '{
   "First Name": "Alice",
   "Last Name": "Johnson",
   "Email": "alice@acme.com",
@@ -194,7 +212,7 @@ frontline object record create standard__people --data '{
 }'
 # → { id: "6625ccc...", ... }
 
-frontline object record create standard__people --data '{
+frontline object record create people --data '{
   "First Name": "Bob",
   "Last Name": "Smith",
   "Email": "bob@techstart.io",
@@ -206,10 +224,10 @@ frontline object record create standard__people --data '{
 ### Create deals
 
 ```bash
-# Use option IDs from `frontline object field list standard__deals`
+# Use option IDs from `frontline object field list deals`
 # Stage options: 1=Lead, 2=In Progress, 3=Won, 4=Lost
 
-frontline object record create standard__deals --data '{
+frontline object record create deals --data '{
   "Name": "Acme Enterprise License",
   "Stage": [2],
   "Value": 150000
@@ -223,36 +241,36 @@ frontline object record create standard__deals --data '{
 
 ```bash
 # Alice works at Acme
-frontline object relation link standard__people 6625ccc... Companies 6625aaa...
+frontline object relation link people 6625ccc... Companies 6625aaa...
 
 # Bob works at TechStart
-frontline object relation link standard__people 6625ddd... Companies 6625bbb...
+frontline object relation link people 6625ddd... Companies 6625bbb...
 ```
 
 ### Link deal → company and deal → person
 
 ```bash
 # The Acme deal belongs to Acme Corp
-frontline object relation link standard__deals 6625eee... Company 6625aaa...
+frontline object relation link deals 6625eee... Company 6625aaa...
 
 # Alice is the contact for this deal
-frontline object relation link standard__deals 6625eee... People 6625ccc...
+frontline object relation link deals 6625eee... People 6625ccc...
 ```
 
 ### Verify links
 
 ```bash
 # What company does Alice belong to?
-frontline object relation get standard__people 6625ccc... Companies
+frontline object relation get people 6625ccc... Companies
 
 # Who are the contacts for the Acme deal?
-frontline object relation get standard__deals 6625eee... People
+frontline object relation get deals 6625eee... People
 
 # Which deals belong to Acme Corp? (reverse lookup)
-frontline object relation find-by standard__deals Company 6625aaa...
+frontline object relation find-by deals Company 6625aaa...
 
 # Which people work at Acme Corp? (reverse lookup)
-frontline object relation find-by standard__people Companies 6625aaa...
+frontline object relation find-by people Companies 6625aaa...
 ```
 
 ## Step 6 — Set Up Pipeline Views
@@ -261,10 +279,10 @@ frontline object relation find-by standard__people Companies 6625aaa...
 
 ```bash
 # Get the field IDs to include in each record type
-frontline object field list standard__deals
+frontline object field list deals
 # → Use the IDs for Name, Stage, Value, People, Company
 
-frontline object record-type create standard__deals --data '{
+frontline object record-type create deals --data '{
   "name": "active_pipeline",
   "displayName": "Active Pipeline",
   "columnIds": [1, 2, 3, 5, 8]
@@ -277,14 +295,14 @@ frontline object record-type create standard__deals --data '{
 ```bash
 # Use the Stage field ID for grouping (e.g., field ID 2)
 # Create directly on the object (no record type needed)
-frontline object view create standard__deals --data '{
+frontline object view create deals --data '{
   "name": "Pipeline Board",
   "type": "KANBAN",
   "metadata": { "groupingColumnId": 2 }
 }'
 
 # Or scoped to a specific record type with --record-type <id>
-frontline object view create standard__deals --record-type 7 --data '{
+frontline object view create deals --record-type 7 --data '{
   "name": "Pipeline Board",
   "type": "KANBAN",
   "metadata": { "groupingColumnId": 2 }
@@ -299,13 +317,13 @@ Refine your views to show only the most important information:
 
 ```bash
 # Set order of columns/fields
-frontline object view update standard__deals <view-id> --column-order "Name, Stage, Value, Company"
+frontline object view update deals <view-id> --column-order "Name, Stage, Value, Company"
 
 # Hide less relevant fields
-frontline object view update standard__deals <view-id> --hidden-columns "Created At, Updated At"
+frontline object view update deals <view-id> --hidden-columns "Created At, Updated At"
 
 # Order fields in the record creation dialog
-frontline object view update standard__deals <view-id> --dialog-field-order "Name, Stage, Value, Probability"
+frontline object view update deals <view-id> --dialog-field-order "Name, Stage, Value, Probability"
 ```
 
 ## Step 8 — Query Your CRM
@@ -313,7 +331,7 @@ frontline object view update standard__deals <view-id> --dialog-field-order "Nam
 ### Find high-value deals
 
 ```bash
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "operator": "and",
   "conditions": [
     { "path": "[Value]", "operator": "gte", "value": 50000 },
@@ -325,7 +343,7 @@ frontline object record list standard__deals --query '{
 ### Find contacts with no company
 
 ```bash
-frontline object record list standard__people --query '{
+frontline object record list people --query '{
   "path": "[Companies]", "operator": "isNull"
 }'
 ```
@@ -333,29 +351,29 @@ frontline object record list standard__people --query '{
 ### Search across fields
 
 ```bash
-frontline object record list standard__people --search "alice"
-frontline object record list standard__companies --search "tech"
+frontline object record list people --search "alice"
+frontline object record list companies --search "tech"
 ```
 
 ### Find all contacts at a specific company
 
 ```bash
-frontline object relation find-by standard__people Companies <company-id>
+frontline object relation find-by people Companies <company-id>
 ```
 
 ## Step 8 — Export & Backup
 
 ```bash
 # Export all deals to spreadsheet
-frontline object export xlsx standard__deals --output deals_report.xlsx
+frontline object export xlsx deals --output deals_report.xlsx
 
 # Export filtered data (only won deals)
-frontline object export csv standard__deals \
+frontline object export csv deals \
   --query '{"path": "[Stage]", "operator": "containsAny", "value": [3]}' \
   --output won_deals.csv
 
 # Export all contacts
-frontline object export xlsx standard__people --output contacts_backup.xlsx
+frontline object export xlsx people --output contacts_backup.xlsx
 ```
 
 ## Quick Command Reference

package/dist/skills/crud-operations/SKILL.md

@@ -269,10 +269,10 @@ Create a new record type with a kanban view for a deals pipeline:
 
 ```bash
 # 1. Check current fields
-frontline object field list standard__deals
+frontline object field list deals
 
 # 2. Create a record type (returns record_type_id)
-frontline object record-type create standard__deals --data '{
+frontline object record-type create deals --data '{
   "name": "enterprise",
   "displayName": "Enterprise Deals",
   "columnIds": [1, 2, 5, 8]

package/dist/skills/export-and-delete/SKILL.md

@@ -23,10 +23,10 @@ frontline object export xlsx <name> [--output file.xlsx]
 
 ```bash
 # Export all people
-frontline object export xlsx standard__people
+frontline object export xlsx people
 
 # Export with filter (high-value deals only)
-frontline object export xlsx standard__deals \
+frontline object export xlsx deals \
   --query '{"path": "[Amount]", "operator": "gte", "value": 10000}' \
   --output big_deals.xlsx
 
@@ -46,7 +46,7 @@ frontline object export csv <name> [--output file.csv]
 
 ```bash
 # Export all records as CSV
-frontline object export csv standard__people --output people_backup.csv
+frontline object export csv people --output people_backup.csv
 ```
 
 ### Default Output
@@ -86,11 +86,11 @@ Always export before deleting:
 
 ```bash
 # 1. Export everything
-frontline object export xlsx standard__legacy_deals --output legacy_deals_backup.xlsx
+frontline object export xlsx legacy_deals --output legacy_deals_backup.xlsx
 
 # 2. Verify the export file exists and looks right
 ls -la legacy_deals_backup.xlsx
 
 # 3. Delete the object
-frontline object delete standard__legacy_deals
+frontline object delete legacy_deals
 ```

package/dist/skills/files/SKILL.md

@@ -55,16 +55,16 @@ frontline table file delete <table> <file-id>
 
 ```bash
 # 1. Find the row
-frontline object row list standard__deals --search "Acme Corp"
+frontline object row list deals --search "Acme Corp"
 # → row ID = 6625abc123def456
 
 # 2. List attached files
-frontline object file list standard__deals 6625abc123def456
+frontline object file list deals 6625abc123def456
 # → [{ id: 15, originalName: "contract_v2.pdf", size: 245000, ... }]
 
 # 3. Download a file
-frontline object file download standard__deals 15 --output ./contract_v2.pdf
+frontline object file download deals 15 --output ./contract_v2.pdf
 
 # 4. Delete an outdated file
-frontline object file delete standard__deals 15
+frontline object file delete deals 15
 ```

package/dist/skills/filter-and-query/SKILL.md

@@ -17,18 +17,18 @@ The `frontline table row list` and `frontline object record list` commands accep
 
 ```bash
 # Simple text search across all fields
-frontline object record list standard__people --search "john"
+frontline object record list people --search "john"
 
 # Filter by a single condition
 # TIP: Use 'frontline object field list <name>' to find field names and tag IDs
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "path": "[Amount]",
   "operator": "gte",
   "value": 10000
 }'
 
 # Multiple conditions (AND)
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "operator": "and",
   "conditions": [
     { "path": "[Status]", "operator": "containsAny", "value": [1, 2] },
@@ -37,7 +37,7 @@ frontline object record list standard__deals --query '{
 }'
 
 # Sort results
-frontline object record list standard__people --sort '[{"path": "[Last Name]", "type": "asc"}]'
+frontline object record list people --sort '[{"path": "[Last Name]", "type": "asc"}]'
 ```
 
 ## Path Format
@@ -176,8 +176,8 @@ frontline table row list my_table --page 1 --page-size 50
 ## Filter by Record Type (objects only)
 
 ```bash
-frontline object record list standard__people --record-type lead
-frontline object record list standard__deals --record-type "all"
+frontline object record list people --record-type lead
+frontline object record list deals --record-type "all"
 ```
 
 ## Full Example
@@ -185,7 +185,7 @@ frontline object record list standard__deals --record-type "all"
 Find all open deals worth over $10k, owned by a specific company, sorted by amount:
 
 ```bash
-frontline object record list standard__deals \
+frontline object record list deals \
   --query '{
     "operator": "and",
     "conditions": [

package/dist/skills/flow-builder/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: flow-builder
+description: Build valid Frontline assistant flows from CLI commands. Use when creating flow graphs, choosing conversation node payloads, connecting nodes, or validating flow structure before execution.
+allowed-tools: Bash(frontline:*)
+---
+
+# Flow Builder
+
+## Default Workflow
+
+1. Select the agent:
+
+```bash
+frontline agents use <agentId>
+```
+
+2. Create or select a flow:
+
+```bash
+frontline agents flows create --name "Flow name"
+frontline agents flows use <flowId>
+```
+
+3. Inspect before each change:
+
+```bash
+frontline agents flows graph --table
+```
+
+## Valid Flow Rules
+
+- Supported nodes: `START`, `TRIGGER_INTENT`, `SAY_AI`, `RESPONSE_AI`, `TOOLS_AI`, `API`, `CONDITIONAL_ROUTING`, `DYNAMIC_TABLES`.
+- Use exactly one initial node: `START` or `TRIGGER_INTENT`.
+- `data.type` must match the node `type`.
+- Edges cannot point from a node to itself.
+- Edges cannot create cycles.
+- `CONDITIONAL_ROUTING` and `TOOLS_AI` can use multiple outgoing handles.
+- Other nodes should use one outgoing edge.
+- Deleting a node removes all incoming and outgoing edges.
+
+## Variables And Intents
+
+Use variables in text fields as `{VARIABLE_NAME}`. The name must match the agent
+variable exactly.
+
+```bash
+frontline agents variables create --name customer_name --description "Customer name"
+frontline agents intents create --name cancellation --phrases '["cancel order","stop subscription"]'
+```
+
+Flow fields with variable replacement include API `url`, `headers[].value`,
+`parameters[].value`, `body`; Say AI `message` and `prompt`; Response AI
+`instructions`; Tools AI `instructions`; Conditional Routing AI
+`conditions[].expression`; and Dynamic Tables `rowId`, `search`, and `rowData`
+values.
+
+## nodeId Format
+
+All node IDs **must** follow the pattern `node_<uuid>`. Names like `start_1` or `api_1` will fail validation.
+
+```
+node_a1b2c3d4-e5f6-7890-abcd-ef1234567890
+```
+
+## Node Payloads
+
+Start:
+
+```bash
+frontline agents flows nodes create --data '{"nodeId":"node_11111111-1111-1111-1111-111111111111","type":"START","position":{"positionX":0,"positionY":0}}'
+```
+
+Intent trigger:
+
+```bash
+frontline agents flows nodes create --data '{"nodeId":"node_11111111-1111-1111-1111-111111111111","type":"TRIGGER_INTENT","position":{"positionX":0,"positionY":0},"data":{"type":"TRIGGER_INTENT","intentIds":[123],"agenticRouting":null}}'
+```
+
+Say AI:
+
+```bash
+frontline agents flows nodes create --data '{"nodeId":"node_22222222-2222-2222-2222-222222222222","type":"SAY_AI","position":{"positionX":320,"positionY":0},"data":{"type":"SAY_AI","sayWithAi":false,"message":"Hello!"}}'
+```
+
+API:
+
+```bash
+frontline agents flows nodes create --data '{"nodeId":"node_33333333-3333-3333-3333-333333333333","type":"API","position":{"positionX":640,"positionY":0},"data":{"type":"API","url":"https://example.com","method":"GET","headers":[]}}'
+```
+
+Conditional routing:
+
+```bash
+frontline agents flows nodes create --data '{"nodeId":"node_44444444-4444-4444-4444-444444444444","type":"CONDITIONAL_ROUTING","position":{"positionX":960,"positionY":0},"data":{"type":"CONDITIONAL_ROUTING","routingType":"DYNAMIC","conditions":[{"handleId":"yes","expression":"input == true"},{"handleId":"no","expression":"input != true"}]}}'
+```
+
+## Edges
+
+Connect nodes:
+
+```bash
+frontline agents flows edges add --source node_11111111-1111-1111-1111-111111111111 --source-handle default --target node_22222222-2222-2222-2222-222222222222 --target-handle default
+```
+
+Connect routing handles:
+
+```bash
+frontline agents flows edges add --source node_44444444-4444-4444-4444-444444444444 --source-handle yes --target node_33333333-3333-3333-3333-333333333333 --target-handle default
+frontline agents flows edges add --source node_44444444-4444-4444-4444-444444444444 --source-handle no  --target node_22222222-2222-2222-2222-222222222222 --target-handle default
+```
+
+Remove an edge:
+
+```bash
+frontline agents flows edges remove --source node_11111111-1111-1111-1111-111111111111 --source-handle default --target node_22222222-2222-2222-2222-222222222222 --target-handle default
+```
+
+## Updates
+
+```bash
+frontline agents flows nodes update node_22222222-2222-2222-2222-222222222222 --data '{"alias":"Greeting"}'
+frontline agents flows nodes delete node_22222222-2222-2222-2222-222222222222
+frontline agents flows update --name "Flow name" --status ACTIVE
+```