ethos-cli 0.8.0 → 0.9.0

package/dist/bin/ethos.js

@@ -13,6 +13,7 @@ import { registerHooks } from "../commands/hooks.js";
 import { registerLists } from "../commands/lists.js";
 import { registerSkills } from "../commands/skills.js";
 import { registerTables } from "../commands/tables.js";
+import { registerWorkflows } from "../commands/workflows.js";
 import { registerWorkspaceContext } from "../commands/workspace-context.js";
 import { addGlobalOptions } from "../lib/config.js";
 import { printError } from "../lib/output.js";
@@ -33,6 +34,7 @@ export function createEthosProgram() {
     registerLists(program);
     registerSkills(program);
     registerTables(program);
+    registerWorkflows(program);
     registerWorkspaceContext(program);
     return program;
 }

package/dist/bin/ethos.js.map

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

package/dist/commands/workflows.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerWorkflows(program: Command): void;

package/dist/commands/workflows.js

@@ -0,0 +1,148 @@
+import { collect, compactObject, jsonRequest, parsePositiveInteger, pathId, withClient } from "../lib/command-helpers.js";
+import { printResult } from "../lib/output.js";
+const STEP_CONFIG_KEYS = {
+    add_to_campaign: "campaign_id",
+    add_to_table: "table_id",
+};
+function parseStepOption(value, position) {
+    const separator = value.indexOf(":");
+    if (separator === -1) {
+        throw new Error(`--step must look like <action>:<id> or <action>:<json>, got '${value}'`);
+    }
+    const actionType = value.slice(0, separator);
+    const rest = value.slice(separator + 1);
+    let config;
+    if (rest.trim().startsWith("{")) {
+        config = JSON.parse(rest);
+    }
+    else {
+        const configKey = STEP_CONFIG_KEYS[actionType];
+        if (!configKey) {
+            throw new Error(`Unknown step action '${actionType}'; pass explicit JSON config as <action>:{"..."}`);
+        }
+        config = { [configKey]: rest };
+    }
+    return { position, action_type: actionType, config };
+}
+function parseFilterOption(value) {
+    const separator = value.indexOf("=");
+    if (separator === -1) {
+        throw new Error(`--filter must look like <field>=<value>, got '${value}'`);
+    }
+    return { field: value.slice(0, separator), op: "equals", value: value.slice(separator + 1) };
+}
+function parseJsonOption(value, name) {
+    if (!value)
+        return {};
+    try {
+        const parsed = JSON.parse(value);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("not an object");
+        }
+        return parsed;
+    }
+    catch {
+        throw new Error(`${name} must be a JSON object.`);
+    }
+}
+export function registerWorkflows(program) {
+    const signals = program.command("signals").description("Browse signal types available as workflow triggers");
+    const signalsListCommand = signals.command("list").description("List signal types and their config schemas");
+    signalsListCommand.action(async () => {
+        await withClient(signalsListCommand, async (client, config) => {
+            const definitions = await client.request("/v1/signal-defs");
+            printResult(config, {
+                label: `${definitions.length} signal types`,
+                data: definitions,
+            });
+        });
+    });
+    const workflows = program.command("workflows").alias("workflow").description("Manage signal-triggered workflows");
+    const createCommand = workflows
+        .command("create <name>")
+        .description("Create a draft workflow from a signal trigger and steps")
+        .requiredOption("--signal <key>", "signal key from `ethos signals list`")
+        .option("--config <json>", "trigger config JSON for the signal")
+        .option("--description <text>", "workflow description")
+        .option("--step <action:id-or-json>", "workflow step, e.g. add_to_campaign:<campaign-id> or add_to_table:<table-id>; repeatable", collect, [])
+        .option("--filter <field=value>", "only fire when the match payload field equals value; repeatable", collect, [])
+        .option("--cooldown <minutes>", "per-person cooldown window in minutes");
+    createCommand.action(async (name) => {
+        await withClient(createCommand, async (client, config) => {
+            const options = createCommand.opts();
+            if (options.step.length === 0) {
+                throw new Error("At least one --step is required.");
+            }
+            const payload = compactObject({
+                name,
+                description: options.description,
+                signal_key: options.signal,
+                trigger_config: parseJsonOption(options.config, "--config"),
+                payload_filters: options.filter.map(parseFilterOption),
+                cooldown_minutes: options.cooldown ? parsePositiveInteger(options.cooldown, "--cooldown") : undefined,
+                steps: options.step.map((step, index) => parseStepOption(step, index)),
+            });
+            const detail = await client.request("/v1/workflows", jsonRequest("POST", payload));
+            printResult(config, {
+                label: `Created draft workflow ${detail.workflow.name} (${detail.workflow.id})`,
+                data: detail,
+            });
+        });
+    });
+    const listCommand = workflows.command("list").description("List workflows");
+    listCommand.action(async () => {
+        await withClient(listCommand, async (client, config) => {
+            printResult(config, await client.request("/v1/workflows"));
+        });
+    });
+    const getCommand = workflows.command("get <workflow-id>").description("Show a workflow's trigger and steps");
+    getCommand.action(async (workflowId) => {
+        await withClient(getCommand, async (client, config) => {
+            printResult(config, await client.request(`/v1/workflows/${pathId(workflowId)}`));
+        });
+    });
+    const activateCommand = workflows
+        .command("activate <workflow-id>")
+        .description("Start watching: the workflow fires on new signal matches")
+        .option("--backfill", "also process existing activity, then keep watching");
+    activateCommand.action(async (workflowId) => {
+        await withClient(activateCommand, async (client, config) => {
+            const options = activateCommand.opts();
+            const detail = await client.request(`/v1/workflows/${pathId(workflowId)}/activate`, jsonRequest("POST", { backfill: Boolean(options.backfill) }));
+            printResult(config, {
+                label: `Workflow ${detail.workflow.name} is now watching`,
+                data: detail,
+            });
+        });
+    });
+    const pauseCommand = workflows.command("pause <workflow-id>").description("Pause an active workflow");
+    pauseCommand.action(async (workflowId) => {
+        await withClient(pauseCommand, async (client, config) => {
+            printResult(config, await client.request(`/v1/workflows/${pathId(workflowId)}/pause`, { method: "POST" }));
+        });
+    });
+    const archiveCommand = workflows
+        .command("archive <workflow-id>")
+        .description("Archive a workflow and release its watcher");
+    archiveCommand.action(async (workflowId) => {
+        await withClient(archiveCommand, async (client, config) => {
+            printResult(config, await client.request(`/v1/workflows/${pathId(workflowId)}/archive`, { method: "POST" }));
+        });
+    });
+    const runsCommand = workflows
+        .command("runs <workflow-id>")
+        .description("Show the match feed: who matched, when, and step outcomes")
+        .option("--limit <count>", "max matches to return (default 50)");
+    runsCommand.action(async (workflowId) => {
+        await withClient(runsCommand, async (client, config) => {
+            const options = runsCommand.opts();
+            const limit = options.limit ? parsePositiveInteger(options.limit, "--limit", 200) : 50;
+            const feed = await client.request(`/v1/workflows/${pathId(workflowId)}/runs?limit=${limit}`);
+            printResult(config, {
+                label: `${feed.length} matches`,
+                data: feed,
+            });
+        });
+    });
+}
+//# sourceMappingURL=workflows.js.map

package/dist/commands/workflows.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethos-cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Commander-based CLI for Ethos table operations",
   "homepage": "https://github.com/cluster-software/ethos#readme",
   "repository": {

package/skills/enrich-contact-info.md

@@ -22,6 +22,12 @@ Prefer Ethos MCP tools when available:
 2. Inspect the sample result or open the returned table URL.
 3. Call `enrich_contact_info` with the returned contact-info column ID and `scope: "empty"`.
 
+The `table_id` must be a PEOPLE table, never the company table a sourcing run
+started from. After people sourcing, `inspect_table_summary` on the company
+table returns the linked `people_table_id` once it exists; if it does not exist
+yet, call `create_people_table` on the company table first and enrich the table
+it returns.
+
 Use the CLI sections below only when MCP tools are unavailable or the user
 explicitly asks for the local CLI.
 

package/skills/find-people-at-companies.md

@@ -21,6 +21,10 @@ Prefer Ethos MCP tools when available:
 3. Poll `get_upload_handoff_status` until it returns a `result_table_id`.
 4. Use `search_ethos_tools` for table inspection if column/view IDs are needed.
 5. Call `source_people_from_company_table`, then run a small sample first.
+6. Poll `inspect_table_summary` on the company table until the sourcing run in
+   `recent_runs` is terminal, then call `create_people_table` to materialize the
+   linked people table. Run `enrich_contact_info` and campaign steps against
+   that people table id, never the company table.
 
 Use the CLI/hook sections below only when MCP tools are unavailable or the user
 explicitly asks for the local CLI. Avoid creating duplicate handoffs when MCP,

package/skills/find-people.md

@@ -18,8 +18,13 @@ development or an explicitly requested environment.
 Prefer Ethos MCP tools when available:
 
 1. Call `find_people` with the final natural-language query.
-2. Poll `get_find_people_status` with the returned `search_id`.
-3. Return the people table ID/URL, counts, status, and refinement suggestions.
+2. If the response status is `needs_refinement` with no `search_id`, the query
+   was declined before starting; follow the response `next_action` — either
+   rewrite the query to describe both companies and people, or pivot to
+   `create_table` + `source_people_from_company_table` using
+   `data.company_names`. Do not retry the same query.
+3. Poll `get_find_people_status` with the returned `search_id`.
+4. Return the people table ID/URL, counts, status, and refinement suggestions.
 
 Use the CLI sections below only when MCP tools are unavailable or the user
 explicitly asks for the local CLI.
@@ -130,10 +135,14 @@ ethos find-people start --query "$QUERY" --json
 Save `response.search_id`, `response.parsedParams`, `response.status`, and
 `response.progressMessage`.
 
-If the command returns `success: false`, inspect `error.suggestedAction` and
-`error.parsedParams`. When `suggestedAction` is not `combinedSearch`, tell the
-user the parser understood only company criteria or only person criteria, then
-rewrite the query so it includes both target companies and target individuals.
+If the command returns `success: false`, inspect `error.suggestedAction`,
+`error.companyNames`, and `error.parsedParams`. Queries that name specific
+employers are converted to a search over exactly those companies automatically,
+so a decline means the parse could not be run as-is. When `error.companyNames`
+is non-empty, do not retry the same query; pivot to the
+find-people-at-companies flow (create a company table with those companies and
+run people sourcing on it). Otherwise rewrite the query so it includes both
+target companies and target individuals.
 
 After a successful start, summarize the parsed params in plain language. Do not
 paste the full JSON unless the user asks for it.