yeuimu
5fa843df05
A self-built CLI and companion agent skill for operating a deployed
inkreach-teable instance — configuring tables, fields, records, views, and
the project's OWN automation engine.
Why not the official 'teable' CLI:
inkreach-teable's automation is self-built with a different contract:
- conditions (not filter), fieldIds (not watchFieldIds)
- recordCondition (not recordMatchesConditions)
- webhook route /api/webhook/{baseId}/{wfId} (not the /base//workflow/ form)
- scheduledTime backend honors only timing.type + timing.interval
The official CLI targets the upstream contract and 404s/misconfigures here.
Table/field/record/view APIs ARE upstream-compatible, but automation is not.
inkreach CLI (packages/inkreach-cli/):
- Node.js + commander, zero extra runtime deps
- Uses node:http (NOT fetch — Node 24 fetch drops Authorization header)
- Commands: auth (login/status/token), base/table/field/record/view,
workflow (list/get/create/update/delete/activate/deactivate/test),
trigger set (8 types, builds correct config keys), action add/update/delete
(6 types), secret, runs (list/get/rerun), fire (button-click/webhook), sql
- --json mode for agent parsing; GET->modify->PUT whole-graph for node edits
- Verified end-to-end: create workflow -> set webhook trigger -> add script
action -> activate -> fire webhook -> runs list (succeeded)
inkreach-teable-ops skill (.agents/skills/inkreach-teable-ops/):
- SKILL.md entry: module map, routing rules, 11 key constraints (the real
contract keys), execution rules, error recovery
- guides/: cli-reference, automation-guide, tables-fields, instance-access,
development (build/restart, known gotchas)
- api-reference/: trigger-types (8 triggers, exact config), action-types
(6 actions, sandbox globals), field-types (21 types incl. Button)
- metadata.json + install.sh
43 lines
1.9 KiB
JavaScript
43 lines
1.9 KiB
JavaScript
#!/usr/bin/env node
|
|
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
/**
|
|
* inkreach — CLI for operating inkreach-teable.
|
|
*
|
|
* Entry point. Sets up the global commander program and mounts command groups.
|
|
*/
|
|
const commander_1 = require("commander");
|
|
const package_json_1 = require("../package.json");
|
|
const auth_1 = require("./commands/auth");
|
|
const workflow_1 = require("./commands/workflow");
|
|
const resources_1 = require("./commands/resources");
|
|
const extras_1 = require("./commands/extras");
|
|
const program = new commander_1.Command();
|
|
program
|
|
.name('inkreach')
|
|
.description('Operate inkreach-teable: tables, fields, records, views, and the self-built automation engine (8 triggers + 6 actions).\n' +
|
|
'Use --json for machine-readable output (agent parsing).')
|
|
.version(`inkreach ${package_json_1.version}`, '-v, --version');
|
|
// Global options (highest precedence over config file + env).
|
|
program
|
|
.option('--endpoint <url>', 'Backend URL (default http://localhost:3000)')
|
|
.option('--token <token>', 'Personal Access Token')
|
|
.option('--base-id <id>', 'Default base id')
|
|
.option('--json', 'Output raw JSON for agent parsing')
|
|
.option('--debug', 'Print requests/responses to stderr (verbose)');
|
|
// Command groups
|
|
program.addCommand((0, auth_1.authCommand)());
|
|
for (const c of (0, resources_1.baseResourceCommands)())
|
|
program.addCommand(c);
|
|
program.addCommand((0, workflow_1.workflowCommand)());
|
|
program.addCommand((0, workflow_1.triggerCommand)());
|
|
program.addCommand((0, workflow_1.actionCommand)());
|
|
program.addCommand((0, extras_1.secretCommand)());
|
|
program.addCommand((0, extras_1.runsCommand)());
|
|
program.addCommand((0, extras_1.fireCommand)());
|
|
program.addCommand((0, extras_1.sqlCommand)());
|
|
program.parseAsync(process.argv).catch((err) => {
|
|
process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
process.exit(1);
|
|
});
|