cli-jaw 0.1.6 → 0.1.8

package/skills_ref/whatsapp/scripts/query-rows.js

@@ -1,71 +0,0 @@
-import { kapsoConfigFromEnv, kapsoRequest } from './lib/databases/kapso-api.js';
-import { hasHelpFlag, parseFlags, requireFlag, parseJsonObjectOptional, parseNumber } from './lib/databases/args.js';
-
-function ok(data) {
-  return { ok: true, data };
-}
-
-function err(message, details) {
-  return { ok: false, error: { message, details } };
-}
-
-function buildQuery(flags) {
-  const params = new URLSearchParams();
-  const filters = parseJsonObjectOptional(flags.filters, 'filters');
-  if (filters) {
-    Object.entries(filters).forEach(([key, value]) => {
-      params.set(key, String(value));
-    });
-  }
-  if (typeof flags.select === 'string' && flags.select.length > 0) {
-    params.set('select', flags.select);
-  }
-  if (typeof flags.order === 'string' && flags.order.length > 0) {
-    params.set('order', flags.order);
-  }
-  const limit = parseNumber(flags.limit, 'limit');
-  if (limit !== undefined) {
-    params.set('limit', String(limit));
-  }
-  const offset = parseNumber(flags.offset, 'offset');
-  if (offset !== undefined) {
-    params.set('offset', String(offset));
-  }
-  const query = params.toString();
-  return query ? `?${query}` : '';
-}
-
-async function main() {
-  const argv = process.argv.slice(2);
-  if (hasHelpFlag(argv)) {
-    console.log(
-      JSON.stringify(
-        {
-          ok: true,
-          usage:
-            'node scripts/query-rows.js --table <name> [--filters <json>] [--select <cols>] [--order <col.asc|desc>] [--limit <n>] [--offset <n>]',
-          env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-        },
-        null,
-        2
-      )
-    );
-    return 0;
-  }
-
-  try {
-    const flags = parseFlags(argv);
-    const table = requireFlag(flags, 'table');
-    const query = buildQuery(flags);
-    const config = kapsoConfigFromEnv();
-    const data = await kapsoRequest(config, `/platform/v1/db/${encodeURIComponent(table)}${query}`);
-    console.log(JSON.stringify(ok(data), null, 2));
-    return 0;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(JSON.stringify(err('Command failed', { message }), null, 2));
-    return 1;
-  }
-}
-
-main().then((code) => process.exit(code));

package/skills_ref/whatsapp/scripts/reload-props.js

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag } from './lib/workflows/args.js';
-
-function usage() {
-  return ok({
-    usage: 'node scripts/reload-props.js --action-id <id> --account-id <id> [--configured-props <json>] [--dynamic-props-id <id>]',
-    notes: [
-      'Use accounts[].pipedream_account_id for --account-id.',
-      'If you pass an internal account UUID, the script will try to resolve it.'
-    ],
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-  });
-}
-
-function parseJson(value, label) {
-  if (!value) return undefined;
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    throw new Error(`Invalid JSON for ${label}: ${String(error?.message || error)}`);
-  }
-}
-
-function normalizeAccounts(payload) {
-  if (Array.isArray(payload?.accounts)) return payload.accounts;
-  if (Array.isArray(payload?.accounts?.accounts)) return payload.accounts.accounts;
-  if (Array.isArray(payload)) return payload;
-  return [];
-}
-
-async function resolveAccountId(config, accountId) {
-  if (accountId.startsWith('apn_')) return accountId;
-
-  const response = await requestJson(config, {
-    method: 'GET',
-    path: '/platform/v1/integrations/accounts'
-  });
-
-  if (!response.ok) {
-    throw new Error('Unable to resolve account id. Use list-accounts and pass pipedream_account_id.');
-  }
-
-  const accounts = normalizeAccounts(response.data);
-  const match = accounts.find((account) => account.id === accountId);
-  if (match?.pipedream_account_id) return match.pipedream_account_id;
-
-  throw new Error('account-id must be pipedream_account_id (use list-accounts output).');
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const actionId = getFlag(parsed.flags, 'action-id');
-  const accountId = getFlag(parsed.flags, 'account-id');
-  if (!actionId || !accountId) {
-    printJson(err('action-id and account-id are required'));
-    return 2;
-  }
-
-  let configuredProps = {};
-  try {
-    const provided = parseJson(getFlag(parsed.flags, 'configured-props'), 'configured-props');
-    configuredProps = provided || {};
-  } catch (error) {
-    printJson(err('Failed to parse configured-props', { message: error.message }));
-    return 2;
-  }
-
-  const config = loadConfig();
-  let resolvedAccountId = accountId;
-
-  try {
-    resolvedAccountId = await resolveAccountId(config, accountId);
-  } catch (error) {
-    printJson(err('Failed to resolve account-id', { message: error.message }));
-    return 2;
-  }
-
-  if (!Object.keys(configuredProps).length) {
-    configuredProps = { account_id: resolvedAccountId };
-  }
-
-  const response = await requestJson(config, {
-    method: 'POST',
-    path: `/platform/v1/integrations/actions/${actionId}/reload_props`,
-    body: {
-      configured_props: configuredProps,
-      dynamic_props_id: getFlag(parsed.flags, 'dynamic-props-id')
-    }
-  });
-
-  if (!response.ok) {
-    printJson(err('Failed to reload props', response.raw, false, response.status));
-    return 2;
-  }
-
-  printJson(ok({ result: response.data }));
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});

package/skills_ref/whatsapp/scripts/resume-execution.js

@@ -1,75 +0,0 @@
-#!/usr/bin/env node
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag } from './lib/workflows/args.js';
-
-function usage() {
-  return ok({
-    usage: 'node scripts/resume-execution.js <execution-id> --message <json> [--variables <json>]',
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY'],
-    examples: [
-      'node scripts/resume-execution.js exec_123 --message \'{"data":{"text":"hi"}}\''
-    ]
-  });
-}
-
-function parseJson(value, label) {
-  if (!value) return undefined;
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    throw new Error(`Invalid JSON for ${label}: ${String(error?.message || error)}`);
-  }
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const executionId = parsed.args[0] || getFlag(parsed.flags, 'execution-id');
-  if (!executionId) {
-    printJson(err('execution_id is required'));
-    return 2;
-  }
-
-  let message;
-  let variables;
-  try {
-    message = parseJson(getFlag(parsed.flags, 'message'), 'message');
-    variables = parseJson(getFlag(parsed.flags, 'variables'), 'variables');
-  } catch (error) {
-    printJson(err('Failed to parse JSON', { message: error.message }));
-    return 2;
-  }
-
-  if (!message || typeof message !== 'object') {
-    printJson(err('message is required and must be a JSON object'));
-    return 2;
-  }
-
-  const body = { message };
-  if (variables) body.variables = variables;
-
-  const config = loadConfig();
-  const response = await requestJson(config, {
-    method: 'POST',
-    path: `/platform/v1/workflow_executions/${executionId}/resume`,
-    body
-  });
-
-  if (!response.ok) {
-    printJson(err('Failed to resume execution', response.raw, false, response.status));
-    return 2;
-  }
-
-  printJson(ok({ execution: response.data }));
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});

package/skills_ref/whatsapp/scripts/search-actions.js

@@ -1,64 +0,0 @@
-#!/usr/bin/env node
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag } from './lib/workflows/args.js';
-
-function usage() {
-  return ok({
-    usage: 'node scripts/search-actions.js --query <text> [--app-slug <slug>]',
-    notes: [
-      'Prefer one-word queries (ex: "calendar", "slack", "hubspot").',
-      'Use --app-slug to narrow results to a single app.',
-      'action_id equals the action key returned in results.'
-    ],
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-  });
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const query = getFlag(parsed.flags, 'query');
-  if (!query) {
-    printJson(err('query is required'));
-    return 2;
-  }
-
-  const config = loadConfig();
-  const response = await requestJson(config, {
-    method: 'GET',
-    path: '/platform/v1/integrations/actions',
-    query: {
-      query,
-      app_slug: getFlag(parsed.flags, 'app-slug')
-    }
-  });
-
-  if (!response.ok) {
-    printJson(err('Failed to search actions', response.raw, false, response.status));
-    return 2;
-  }
-
-  const raw = response.data;
-  const actions = Array.isArray(raw?.actions) ? raw.actions : (Array.isArray(raw) ? raw : []);
-  const mapped = actions.map((action) => ({
-    ...action,
-    action_id: action.action_id || action.key
-  }));
-  const payload = Array.isArray(raw) ? mapped : { ...raw, actions: mapped };
-
-  printJson(ok({
-    actions: payload,
-    note: 'Use action_id (same as key) with get-action-schema/create-integration.'
-  }));
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});

package/skills_ref/whatsapp/scripts/update-execution-status.js

@@ -1,51 +0,0 @@
-#!/usr/bin/env node
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag } from './lib/workflows/args.js';
-
-function usage() {
-  return ok({
-    usage: 'node scripts/update-execution-status.js <execution-id> --status <ended|handoff|waiting>',
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-  });
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const executionId = parsed.args[0] || getFlag(parsed.flags, 'execution-id');
-  if (!executionId) {
-    printJson(err('execution_id is required'));
-    return 2;
-  }
-
-  const status = getFlag(parsed.flags, 'status');
-  if (!status) {
-    printJson(err('status is required'));
-    return 2;
-  }
-
-  const config = loadConfig();
-  const response = await requestJson(config, {
-    method: 'PATCH',
-    path: `/platform/v1/workflow_executions/${executionId}`,
-    body: { workflow_execution: { status } }
-  });
-
-  if (!response.ok) {
-    printJson(err('Failed to update execution status', response.raw, false, response.status));
-    return 2;
-  }
-
-  printJson(ok({ execution: response.data }));
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});

package/skills_ref/whatsapp/scripts/update-function.js

@@ -1,65 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { kapsoConfigFromEnv, kapsoRequest } from './lib/functions/kapso-api.js';
-import { hasHelpFlag, parseFlags, requireFlag } from './lib/functions/args.js';
-
-function ok(data) {
-  return { ok: true, data };
-}
-
-function err(message, details) {
-  return { ok: false, error: { message, details } };
-}
-
-function resolveCode(flags) {
-  if (typeof flags.code === 'string' && flags.code.length > 0) {
-    return flags.code;
-  }
-  if (typeof flags['code-file'] === 'string' && flags['code-file'].length > 0) {
-    return readFileSync(flags['code-file'], 'utf8');
-  }
-  throw new Error('Provide --code or --code-file');
-}
-
-async function main() {
-  const argv = process.argv.slice(2);
-  if (hasHelpFlag(argv)) {
-    console.log(
-      JSON.stringify(
-        {
-          ok: true,
-          usage:
-            'node scripts/update-function.js --function-id <id> --name <name> (--code <js> | --code-file <path>) [--description <text>]',
-          env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-        },
-        null,
-        2
-      )
-    );
-    return 0;
-  }
-
-  try {
-    const flags = parseFlags(argv);
-    const functionId = requireFlag(flags, 'function-id');
-    const name = requireFlag(flags, 'name');
-    const code = resolveCode(flags);
-    const payload = { name, code };
-    if (typeof flags.description === 'string' && flags.description.length > 0) {
-      payload.description = flags.description;
-    }
-    const config = kapsoConfigFromEnv();
-    const data = await kapsoRequest(config, `/platform/v1/functions/${encodeURIComponent(functionId)}`, {
-      method: 'PATCH',
-      body: JSON.stringify({ function: payload })
-    });
-
-    console.log(JSON.stringify(ok(data), null, 2));
-    return 0;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(JSON.stringify(err('Command failed', { message }), null, 2));
-    return 1;
-  }
-}
-
-main().then((code) => process.exit(code));

package/skills_ref/whatsapp/scripts/update-graph.js

@@ -1,154 +0,0 @@
-#!/usr/bin/env node
-import { createHash } from 'crypto';
-import { readFileSync } from 'fs';
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag, getNumberFlag } from './lib/workflows/args.js';
-
-function sha256(text) {
-  return createHash('sha256').update(text).digest('hex');
-}
-
-function readFileText(path) {
-  return readFileSync(path, 'utf8');
-}
-
-function normalizeDefinition(input) {
-  if (!input || typeof input !== 'object') return null;
-  const record = input;
-
-  if (record.ok === true && record.data && typeof record.data === 'object') {
-    return normalizeDefinition(record.data);
-  }
-
-  if (record.definition && typeof record.definition === 'object') {
-    return record.definition;
-  }
-
-  if (record.flow && typeof record.flow === 'object') {
-    const flow = record.flow;
-    if (flow.definition && typeof flow.definition === 'object') {
-      return flow.definition;
-    }
-  }
-
-  if (record.workflow && typeof record.workflow === 'object') {
-    const workflow = record.workflow;
-    if (workflow.definition && typeof workflow.definition === 'object') {
-      return workflow.definition;
-    }
-  }
-
-  if (record.nodes && record.edges) {
-    return record;
-  }
-
-  return null;
-}
-
-function parseDefinitionInput(raw) {
-  try {
-    const parsed = JSON.parse(raw);
-    return normalizeDefinition(parsed);
-  } catch {
-    return null;
-  }
-}
-
-function usage() {
-  return ok({
-    usage: 'node scripts/update-graph.js <workflow-id> --expected-lock-version <n> --definition-file <path>|--definition-json <json>',
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-  });
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const workflowId = parsed.args[0] || getFlag(parsed.flags, 'workflow-id');
-  if (!workflowId) {
-    printJson(err('workflow_id is required'));
-    return 2;
-  }
-
-  const expectedLockVersion = getNumberFlag(parsed.flags, 'expected-lock-version')
-    ?? getNumberFlag(parsed.flags, 'lock-version');
-  if (expectedLockVersion === undefined) {
-    printJson(err('expected-lock-version is required'));
-    return 2;
-  }
-
-  const definitionFile = getFlag(parsed.flags, 'definition-file');
-  const definitionJson = getFlag(parsed.flags, 'definition-json');
-  if (!definitionFile && !definitionJson) {
-    printJson(err('definition-file or definition-json is required'));
-    return 2;
-  }
-
-  const rawDefinition = definitionFile ? readFileText(definitionFile) : definitionJson || '';
-  const definition = parseDefinitionInput(rawDefinition);
-  if (!definition) {
-    const source = definitionFile ? 'definition-file' : 'definition-json';
-    printJson(err(`Unable to parse workflow definition from ${source}`));
-    return 2;
-  }
-
-  const config = loadConfig();
-  const current = await requestJson(config, {
-    method: 'GET',
-    path: `/platform/v1/workflows/${workflowId}`
-  });
-
-  if (!current.ok) {
-    printJson(err('Failed to fetch workflow metadata for lock check', current.raw, false, current.status));
-    return 2;
-  }
-
-  const currentLock = current.data.lock_version;
-  if (currentLock !== expectedLockVersion) {
-    printJson(err('Conflict: workflow was modified. Refetch and retry.', {
-      expected_lock_version: expectedLockVersion,
-      current_lock_version: currentLock
-    }));
-    return 2;
-  }
-
-  const update = await requestJson(config, {
-    method: 'PATCH',
-    path: `/platform/v1/workflows/${workflowId}`,
-    body: {
-      workflow: {
-        definition
-      }
-    }
-  });
-
-  if (!update.ok) {
-    printJson(err('Failed to update workflow definition', update.raw, false, update.status));
-    return 2;
-  }
-
-  const pretty = JSON.stringify(definition, null, 2);
-
-  printJson(ok({
-    workflow: {
-      id: update.data.id,
-      name: update.data.name,
-      status: update.data.status,
-      lock_version: update.data.lock_version,
-      updated_at: update.data.updated_at
-    },
-    workflow_graph_sha256: sha256(pretty)
-  }));
-
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});

package/skills_ref/whatsapp/scripts/update-integration.js

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-import { loadConfig, requestJson } from './lib/workflows/kapso-api.js';
-import { ok, err, printJson } from './lib/workflows/result.js';
-import { parseArgs, getFlag, getBooleanFlag } from './lib/workflows/args.js';
-
-function usage() {
-  return ok({
-    usage: 'node scripts/update-integration.js --integration-id <id> [--configured-props <json>] [--name <text>] [--variable-definitions <json>] [--dynamic-props-id <id>]',
-    notes: [
-      'Use --variable-definitions to update required tool input fields.'
-    ],
-    env: ['KAPSO_API_BASE_URL', 'KAPSO_API_KEY']
-  });
-}
-
-function parseJson(value, label) {
-  if (!value) return undefined;
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    throw new Error(`Invalid JSON for ${label}: ${String(error?.message || error)}`);
-  }
-}
-
-async function main() {
-  const parsed = parseArgs(process.argv.slice(2));
-  if (getBooleanFlag(parsed.flags, 'help') || getBooleanFlag(parsed.flags, 'h')) {
-    printJson(usage());
-    return 0;
-  }
-
-  const integrationId = getFlag(parsed.flags, 'integration-id');
-  if (!integrationId) {
-    printJson(err('integration-id is required'));
-    return 2;
-  }
-
-  let configuredProps;
-  let variableDefinitions;
-
-  try {
-    configuredProps = parseJson(getFlag(parsed.flags, 'configured-props'), 'configured-props');
-    variableDefinitions = parseJson(getFlag(parsed.flags, 'variable-definitions'), 'variable-definitions');
-  } catch (error) {
-    printJson(err('Failed to parse JSON', { message: error.message }));
-    return 2;
-  }
-
-  const payload = {};
-  const name = getFlag(parsed.flags, 'name');
-  const dynamicPropsId = getFlag(parsed.flags, 'dynamic-props-id');
-
-  if (name) payload.name = name;
-  if (dynamicPropsId) payload.dynamic_props_id = dynamicPropsId;
-  if (configuredProps) payload.configured_props = configuredProps;
-  if (variableDefinitions) payload.variable_definitions = variableDefinitions;
-
-  if (!Object.keys(payload).length) {
-    printJson(err('No updates provided'));
-    return 2;
-  }
-
-  const config = loadConfig();
-  const response = await requestJson(config, {
-    method: 'PATCH',
-    path: `/platform/v1/integrations/${integrationId}`,
-    body: payload
-  });
-
-  if (!response.ok) {
-    printJson(err('Failed to update integration', response.raw, false, response.status));
-    return 2;
-  }
-
-  printJson(ok({ integration: response.data }));
-  return 0;
-}
-
-main().catch((error) => {
-  printJson(err('Unhandled error', { message: String(error?.message || error) }));
-  process.exit(1);
-});