@formant/formant-cli 0.3.1 → 0.4.2

package/dist/commands/signal/query.js

@@ -0,0 +1,100 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class SignalsQuery extends BaseCommand {
+    static description = `Query signals by time range and type.
+
+Signal types: manual, eventTrigger, schedule, slack.
+
+Use --investigation to also show ground truth (expected outcome) for each signal.`;
+    static examples = [
+        '<%= config.bin %> signal query --start 2026-01-01',
+        '<%= config.bin %> signal query --start 2026-01-01 --end 2026-02-01 --type eventTrigger',
+        '<%= config.bin %> signal query --start 2026-01-01 --investigation <taskflow-id>',
+        '<%= config.bin %> signal query --start 2026-01-01 --json',
+    ];
+    static flags = {
+        end: Flags.string({
+            description: 'End time (ISO 8601)',
+        }),
+        investigation: Flags.string({
+            char: 'i',
+            description: 'Investigation (taskflow) ID — shows ground truth for signals that have one',
+        }),
+        start: Flags.string({
+            description: 'Start time (ISO 8601)',
+            required: true,
+        }),
+        type: Flags.string({
+            description: 'Filter by signal type',
+            options: ['manual', 'eventTrigger', 'schedule', 'slack'],
+        }),
+    };
+    static summary = 'Query signals by time range';
+    async run() {
+        // Normalize dates to ISO 8601 datetime format
+        const body = {
+            startTime: this.normalizeDateTime(this.flags.start),
+        };
+        if (this.flags.end)
+            body.endTime = this.normalizeDateTime(this.flags.end);
+        if (this.flags.type)
+            body.type = this.flags.type;
+        const result = await this.api('theopolis', 'signals/query', { body });
+        // If investigation flag set, fetch ground truths and merge
+        let groundTruthMap;
+        if (this.flags.investigation) {
+            try {
+                const gtResult = await this.api('theopolis', `taskflows/${this.flags.investigation}/eval/ground-truths`, { method: 'GET' });
+                groundTruthMap = new Map();
+                for (const gt of gtResult.groundTruths ?? []) {
+                    groundTruthMap.set(gt.signalId, gt.expectedOutcome);
+                }
+                for (const signal of result.items ?? []) {
+                    const expectedOutcome = groundTruthMap.get(signal.id);
+                    if (expectedOutcome) {
+                        signal.expectedOutcome = expectedOutcome;
+                    }
+                }
+            }
+            catch {
+                // Continue without ground truths
+            }
+        }
+        if (!this.jsonEnabled()) {
+            const hasGt = this.flags.investigation && groundTruthMap && groundTruthMap.size > 0;
+            const columns = [
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'type', label: 'TYPE', width: 14 },
+                { key: 'status', label: 'STATUS', width: 12 },
+                { key: 'goal', label: 'GOAL', width: 36 },
+                { key: 'createdAt', label: 'CREATED', width: 22 },
+            ];
+            if (hasGt) {
+                columns.push({ key: 'hasGroundTruth', label: 'GT', width: 4 });
+            }
+            const items = (result.items ?? []).map((s) => ({
+                ...s,
+                hasGroundTruth: groundTruthMap?.has(s.id) ? '*' : '',
+            }));
+            this.log(`\nSignals (${this.env}):\n`);
+            this.log(formatTable(items, columns));
+            if (hasGt) {
+                this.log(`\nGround Truths:\n`);
+                for (const signal of result.items ?? []) {
+                    const gt = groundTruthMap.get(signal.id);
+                    if (gt) {
+                        const goal = String(signal.goal ?? '').slice(0, 60);
+                        this.log(`  ${signal.id}`);
+                        this.log(`    Goal:          ${goal}`);
+                        this.log(`    Ground Truth:  ${gt}`);
+                        this.log('');
+                    }
+                }
+            }
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/signal/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/commands/signal/query.ts"],"names":[],"mappings":"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"}

package/dist/commands/signal/set-ground-truth.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class SignalSetGroundTruth extends BaseCommand<typeof SignalSetGroundTruth> {
+    static args: {
+        signalId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        investigationId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        expectedOutcome: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/signal/set-ground-truth.js

@@ -0,0 +1,46 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatDetail } from '../../lib/formatters.js';
+export default class SignalSetGroundTruth extends BaseCommand {
+    static args = {
+        signalId: Args.string({ description: 'Signal ID (UUID)', required: true }),
+        investigationId: Args.string({ description: 'Investigation (taskflow) ID', required: true }),
+        expectedOutcome: Args.string({ description: 'The expected outcome / ground truth for this signal', required: true }),
+    };
+    static description = `Assign a ground truth (expected outcome) to a signal for an investigation.
+
+Ground truths define what the correct outcome should be when an investigation processes
+a given signal. They are used for evaluation and quality measurement of investigation
+workflows.`;
+    static examples = [
+        '<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> "The alarm should be dismissed as a false positive"',
+        '<%= config.bin %> signal set-ground-truth <signal-id> <investigation-id> "Root cause: overheated motor in joint 3" --json',
+    ];
+    static summary = 'Assign ground truth to a signal';
+    async run() {
+        const { expectedOutcome, investigationId, signalId } = this.args;
+        const groundTruth = await this.api('theopolis', `taskflows/${investigationId}/eval/ground-truths`, {
+            body: {
+                expectedOutcome,
+                signalId,
+            },
+        });
+        if (!this.jsonEnabled()) {
+            this.log(`\nGround truth assigned (${this.env}):\n`);
+            this.log(formatDetail({
+                expectedOutcome: groundTruth.expectedOutcome,
+                id: groundTruth.id,
+                investigation: investigationId,
+                signalId: groundTruth.signalId,
+            }, {
+                expectedOutcome: 'Expected Outcome',
+                id: 'Ground Truth ID',
+                investigation: 'Investigation',
+                signalId: 'Signal',
+            }));
+            this.log('');
+        }
+        return groundTruth;
+    }
+}
+//# sourceMappingURL=set-ground-truth.js.map

package/dist/commands/signal/set-ground-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-ground-truth.js","sourceRoot":"","sources":["../../../src/commands/signal/set-ground-truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,WAAwC;IACxF,MAAM,CAAU,IAAI,GAAG;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QACxE,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,6BAA6B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QAC1F,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,qDAAqD,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACnH,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;;;WAIrB,CAAA;IAET,MAAM,CAAU,QAAQ,GAAG;QACzB,8HAA8H;QAC9H,2HAA2H;KAC5H,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,iCAAiC,CAAA;IAEpD,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,IAAI,CAAA;QAE9D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,GAAG,CAChC,WAAW,EACX,aAAa,eAAe,qBAAqB,EACjD;YACE,IAAI,EAAE;gBACJ,eAAe;gBACf,QAAQ;aACT;SACF,CACF,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACpD,IAAI,CAAC,GAAG,CAAC,YAAY,CACnB;gBACE,eAAe,EAAE,WAAW,CAAC,eAAe;gBAC5C,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,aAAa,EAAE,eAAe;gBAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,EACD;gBACE,eAAe,EAAE,kBAAkB;gBACnC,EAAE,EAAE,iBAAiB;gBACrB,aAAa,EAAE,eAAe;gBAC9B,QAAQ,EAAE,QAAQ;aACnB,CACF,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC"}

package/dist/commands/{users → user}/get.js

@@ -9,8 +9,8 @@ export default class UsersGet extends BaseCommand {
 
 Shows user details including email, name, roles, and account settings.`;
     static examples = [
-        '<%= config.bin %> users get <user-id>',
-        '<%= config.bin %> users get <user-id> --json',
+        '<%= config.bin %> user get <user-id>',
+        '<%= config.bin %> user get <user-id> --json',
     ];
     static summary = 'Get user details';
     async run() {

package/dist/commands/user/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/user/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAA4B;IAChE,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACjE,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;uEAEuC,CAAA;IAErE,MAAM,CAAU,QAAQ,GAAG;QACzB,sCAAsC;QACtC,6CAA6C;KAC9C,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAA;IAErC,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAA0B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE;YACrF,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC3C,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;YAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC"}

package/dist/commands/{users → user}/list.js

@@ -5,8 +5,8 @@ export default class UsersList extends BaseCommand {
 
 Shows user accounts, their email addresses, and account status.`;
     static examples = [
-        '<%= config.bin %> users list',
-        '<%= config.bin %> users list --json',
+        '<%= config.bin %> user list',
+        '<%= config.bin %> user list --json',
     ];
     static summary = 'List users';
     async run() {

package/dist/commands/user/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/user/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAA6B;IAClE,MAAM,CAAU,WAAW,GAAG;;gEAEgC,CAAA;IAE9D,MAAM,CAAU,QAAQ,GAAG;QACzB,6BAA6B;QAC7B,oCAAoC;KACrC,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,YAAY,CAAA;IAE/B,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,OAAO,EACP,OAAO,EACP,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAC;gBACzC,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAC;aAC7C,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YACpC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/help.js

@@ -3,17 +3,17 @@ export default class FcliHelp extends Help {
     async showRootHelp() {
         const output = `
    ███████╗ ██████╗██╗     ██╗
-   ██╔════╝██╔════╝██║     ██║     🤖 Formant CLI v${this.config.version}
-   █████╗  ██║     ██║     ██║     ⚡ Manage your robot fleet
-   ██╔══╝  ██║     ██║     ██║     🚀 from the command line
+   ██╔════╝██╔════╝██║     ██║     Formant CLI v${this.config.version}
+   █████╗  ██║     ██║     ██║     Manage your robot fleet
+   ██╔══╝  ██║     ██║     ██║     from the command line
    ██║     ╚██████╗███████╗██║
    ╚═╝      ╚═════╝╚══════╝╚═╝
 
 ABOUT
   Formant is a cloud platform for monitoring, operating, and analyzing robot fleets.
   This CLI lets you interact with your robots, query telemetry data, trigger AI-powered
-  investigations, manage users and permissions, and automate fleet operations — all from
-  your terminal.
+  investigations, delegate tasks to AI personas, and automate fleet operations — all
+  from your terminal.
 
 USAGE
   $ fcli <command> [flags]
@@ -24,23 +24,25 @@ KEY CONCEPTS
   Event          An important occurrence (alert, warning, error) emitted by a device
   Signal         A point of interest that triggers investigation or analysis
   Investigation  AI-powered workflow that analyzes device data and diagnoses issues
+  Persona        An AI agent with specific tools and instructions
   Stream         Real-time telemetry data (battery, temperature, location, sensors)
   Command        Remote instruction sent to a device to perform an action
   Fleet          A logical group of devices (by location, type, or tags)
 
 COMMANDS
   org              View and update your Formant organization
-  devices          Create, list, tag, and manage robots/sensors in your fleet
-  events           View and filter important events emitted by devices
+  device           Create, list, tag, and manage robots/sensors in your fleet
+  event            View and filter important events emitted by devices
   query            Retrieve historical telemetry data and latest sensor values
   ingest           Send telemetry data to devices via the Formant ingestion API
-  signals          List, query, and analyze signals that trigger investigations
-  investigations   Trigger, monitor, and analyze AI-powered diagnostic workflows
-  commands         Send remote commands to devices and view command history
-  event-triggers   Configure rules that automatically generate events and signals
-  users            List and inspect users in your organization
-  fleets           Manage device groups and organize your fleet
-  schedules        Set up recurring tasks and one-time scheduled jobs
+  signal           List, query, and analyze signals that trigger investigations
+  investigation    Trigger, monitor, and analyze AI-powered diagnostic workflows
+  persona          Manage AI personas and delegate async tasks
+  command          Send remote commands to devices and view command history
+  event-trigger    Configure rules that automatically generate events and signals
+  user             List and inspect users in your organization
+  fleet            Manage device groups and organize your fleet
+  schedule         Set up recurring tasks and one-time scheduled jobs
   analytics        Execute custom SQL queries against your analytics database
   kv               Store and retrieve metadata in the key-value store
   help             Display help for fcli
@@ -65,16 +67,16 @@ EXAMPLES
   $ fcli org update --name "Acme Robotics"              # Update org name
 
   # Device management
-  $ fcli devices list --online                          # List all online devices
-  $ fcli devices list --tag location=warehouse          # Filter by tags
-  $ fcli devices create --name "robot-001"              # Create a new device
-  $ fcli devices tag <device-id> --key env --value prod # Add tags
-  $ fcli devices rename <device-id> --name "robot-new"  # Rename a device
+  $ fcli device list --online                           # List all online devices
+  $ fcli device list --tag location=warehouse           # Filter by tags
+  $ fcli device create --name "robot-001"               # Create a new device
+  $ fcli device tag <device-id> --key env --value prod  # Add tags
+  $ fcli device rename <device-id> --name "robot-new"   # Rename a device
 
   # Telemetry queries
   $ fcli query --device <id> --stream battery_level --start 2026-01-01 --end 2026-01-02
   $ fcli query latest-values --device <id> --stream battery_level
-  $ fcli devices streams <device-id>                    # List available streams
+  $ fcli device streams <device-id>                     # List available streams
 
   # Ingest telemetry data
   $ fcli ingest numeric 42.5 --device <id> --stream battery_level
@@ -83,37 +85,41 @@ EXAMPLES
   $ fcli ingest batch --file payload.json               # Batch ingest from file
 
   # Events and monitoring
-  $ fcli events list --severity critical --limit 50     # View critical events
-  $ fcli events list --device <id> --start 2026-01-01  # Events for one device
-  $ fcli events get <event-id>                          # Get event details
+  $ fcli event list --severity critical --limit 50      # View critical events
+  $ fcli event list --device <id> --start 2026-01-01    # Events for one device
+  $ fcli event get <event-id>                           # Get event details
 
-  # AI investigations
-  $ fcli investigations list                            # List all investigations
-  $ fcli investigations trigger <inv-id> <device-id>    # Trigger an investigation
-  $ fcli investigations runs <inv-id>                   # View investigation runs
-  $ fcli investigations stats --start 2026-01-01        # Get investigation metrics
+  # AI personas
+  $ fcli persona list                                   # List all personas
+  $ fcli persona get <persona-id>                       # View persona tools
+  $ fcli persona delegate-task <persona-id> "Analyze recent failures"
+  $ fcli persona task-status <task-id>                  # Check task results
 
-  # Signals (investigation triggers)
-  $ fcli signals list --start 2026-01-01 --end 2026-02-01
-  $ fcli signals query --start 2026-01-01              # Query by time range
-  $ fcli signals count                                  # Count signals by type
-  $ fcli signals get <signal-id>                        # Get signal details
+  # AI investigations
+  $ fcli investigation list                             # List all investigations
+  $ fcli investigation trigger <id> -i "Robot stopped"  # Trigger an investigation
+  $ fcli investigation runs <id>                        # View investigation runs
+
+  # Signals and ground truths
+  $ fcli signal create "Motor overheated on device X"   # Create a manual signal
+  $ fcli signal create "Sensor fault" -i <inv-id> -g "Should detect thermal issue"
+  $ fcli signal list                                    # List all signals
+  $ fcli signal list --investigation <inv-id>           # List with ground truths
+  $ fcli signal query --start 2026-01-01                # Query by time range
+  $ fcli signal set-ground-truth <signal-id> <inv-id> "Expected outcome"
 
   # Remote commands
-  $ fcli commands list                                  # List command templates
-  $ fcli commands for-device <device-id>                # Commands for one device
-  $ fcli commands send <device-id> <template-id> --param speed=10
-  $ fcli commands history <device-id>                   # View command history
+  $ fcli command list                                   # List command templates
+  $ fcli command for-device <device-id>                 # Commands for one device
+  $ fcli command send <device-id> <template-id> --param speed=10
 
   # Event triggers (automation)
-  $ fcli event-triggers list                            # List all trigger rules
-  $ fcli event-triggers get <trigger-id>                # View trigger details
+  $ fcli event-trigger list                             # List all trigger rules
+  $ fcli event-trigger get <trigger-id>                 # View trigger details
 
   # User and fleet management
-  $ fcli users list                                     # List all users
-  $ fcli users get <user-id>                            # View user details
-  $ fcli fleets list                                    # List device groups
-  $ fcli fleets get <fleet-id>                          # View fleet details
+  $ fcli user list                                      # List all users
+  $ fcli fleet list                                     # List device groups
 
   # Analytics and data queries
   $ fcli analytics tables                               # List available tables
@@ -125,10 +131,10 @@ EXAMPLES
   $ fcli kv set <device-id> <key> <value>               # Store a value
 
 TIPS
-  • Use --json with any command to get machine-readable output for scripting
-  • Pipe output to jq for advanced JSON processing: fcli devices list --json | jq
-  • Set --dev or --stage to target non-production environments
-  • Use fcli <command> --help to see detailed help for any command
+  * Use --json with any command to get machine-readable output for scripting
+  * Pipe output to jq for advanced JSON processing: fcli device list --json | jq
+  * Set --dev or --stage to target non-production environments
+  * Use fcli <command> --help to see detailed help for any command
 
 LEARN MORE
   Documentation:  https://formant.io/docs

package/dist/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,IAAI;IACrB,KAAK,CAAC,YAAY;QACnC,MAAM,MAAM,GAAG;;qDAEkC,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIvE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,IAAI;IACrB,KAAK,CAAC,YAAY;QACnC,MAAM,MAAM,GAAG;;kDAE+B,IAAI,CAAC,MAAM,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyIpE,CAAA;QAEG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC;CACF"}

package/dist/lib/api.d.ts

@@ -1,5 +1,5 @@
 import { type Environment } from './config.js';
-export type ApiTarget = 'admin' | 'ingest' | 'query' | 'theopolis';
+export type ApiTarget = 'admin' | 'gateway' | 'ingest' | 'query' | 'theopolis';
 interface RequestOptions {
     body?: unknown;
     method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';

package/dist/lib/api.js

@@ -6,6 +6,9 @@ function buildBaseUrl(env, target) {
         case 'admin': {
             return `${urls.adminApi}/v1/admin`;
         }
+        case 'gateway': {
+            return `${urls.gateway}/api`;
+        }
         case 'ingest': {
             return `${urls.adminApi}/v1/ingest`;
         }

package/dist/lib/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAA;AAU/B,SAAS,YAAY,CAAC,GAAgB,EAAE,MAAiB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAA;QACpC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,IAAI,CAAC,QAAQ,YAAY,CAAA;QACrC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAA;QACtC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,SAAS,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,MAAiB,EACjB,IAAY,EACZ,UAA0B,EAAE;IAE5B,MAAM,EAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAE7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,OAAO,EAAC,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAA;AAU/B,SAAS,YAAY,CAAC,GAAgB,EAAE,MAAiB;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAA;QACpC,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,OAAO,GAAG,IAAI,CAAC,OAAO,MAAM,CAAA;QAC9B,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,IAAI,CAAC,QAAQ,YAAY,CAAA;QACrC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,QAAQ,aAAa,CAAA;QACtC,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,SAAS,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,MAAiB,EACjB,IAAY,EACZ,UAA0B,EAAE;IAE5B,MAAM,EAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAC,GAAG,OAAO,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;QACP,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAA;IAE7C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;AAChC,CAAC"}

package/dist/lib/config.d.ts

@@ -1,6 +1,7 @@
 export type Environment = 'dev' | 'prod' | 'stage';
 export interface EnvUrls {
     adminApi: string;
+    gateway: string;
     queryApi: string;
     theopolis: string;
 }

package/dist/lib/config.js

@@ -1,16 +1,19 @@
 const ENVIRONMENTS = {
     prod: {
         adminApi: 'https://api.formant.io',
+        gateway: 'https://gateway-service-prod-f814f074944f.herokuapp.com',
         queryApi: 'https://api.formant.io',
         theopolis: 'https://theopolis-prod-ad4d9de77f9a.herokuapp.com',
     },
     dev: {
         adminApi: 'https://api-dev.formant.io',
+        gateway: 'https://gateway-service-dev-47d47ae014aa.herokuapp.com',
         queryApi: 'https://api-dev.formant.io',
         theopolis: 'https://theopolis-dev-231bd5d86d0f.herokuapp.com',
     },
     stage: {
         adminApi: 'https://api-stage.formant.io',
+        gateway: 'https://gateway-service-stage-515bbe9b1906.herokuapp.com',
         queryApi: 'https://api-stage.formant.io',
         theopolis: 'https://theopolis-stage-80d087320b3d.herokuapp.com',
     },

package/dist/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAiC;IACjD,IAAI,EAAE;QACJ,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,wBAAwB;QAClC,SAAS,EAAE,mDAAmD;KAC/D;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,4BAA4B;QACtC,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE,kDAAkD;KAC9D;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,8BAA8B;QACxC,SAAS,EAAE,oDAAoD;KAChE;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,GAAgB;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AASA,MAAM,YAAY,GAAiC;IACjD,IAAI,EAAE;QACJ,QAAQ,EAAE,wBAAwB;QAClC,OAAO,EAAE,yDAAyD;QAClE,QAAQ,EAAE,wBAAwB;QAClC,SAAS,EAAE,mDAAmD;KAC/D;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,4BAA4B;QACtC,OAAO,EAAE,wDAAwD;QACjE,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE,kDAAkD;KAC9D;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,8BAA8B;QACxC,OAAO,EAAE,0DAA0D;QACnE,QAAQ,EAAE,8BAA8B;QACxC,SAAS,EAAE,oDAAoD;KAChE;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,GAAgB;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}