@maniflow/lastmile

Last Mile connector package (C-006 package model).

Exports

• commandRegistry for runtime/Hive integration
• CLI wrapper via lastmile

Commands

• tasks.get → GET /tasks/{task_id}
• bindings.list → list executable Last Mile bindings from Convex
• bindings.default → show/set default executable binding persisted locally
• Source OpenAPI: /Users/ericodom/Projects/lastmile/web-apps/apps/lmi/api-playground/openapi

CLI invocation

pnpm --filter @maniflow/lastmile build

# Show command help
node packages/connectors/lastmile/dist/cli.js --help

# Discover usable binding IDs quickly
node packages/connectors/lastmile/dist/cli.js bindings list
node packages/connectors/lastmile/dist/cli.js bindings list --json

# View/set default binding (stored in ~/.lastmile/config.json)
node packages/connectors/lastmile/dist/cli.js bindings default --show
node packages/connectors/lastmile/dist/cli.js bindings default --set <assistantConnectorBindingId>

# Run task lookup (binding now optional if resolvable)
node packages/connectors/lastmile/dist/cli.js tasks get --id <taskId>
node packages/connectors/lastmile/dist/cli.js tasks get \
  --binding <assistantConnectorBindingId> \
  --id <taskId>

Binding resolution order for tasks get

1. --binding if provided
2. default binding from ~/.lastmile/config.json if set
   • if that stored default is stale (deleted/non-executable), the CLI auto-clears it from config and continues fallback resolution
3. exactly one executable Last Mile binding from Convex
4. otherwise fail with actionable guidance to pass --binding or set a default

bindings default --show also auto-heals stale saved defaults. It never prints an invalid binding ID; stale values are cleared first.

Commands resolve connector execution config from Convex:

• connector definition (baseUrl, authScheme)
• instance binding (credentialRef)
• vault secret via credentialRef