v0.5.0

v0.5.0 — jobs command group

This release adds a new top-level jobs command group for managing long-running jobs on the getlark platform, starting with workflow_import jobs for bulk-creating workflows from a JSON file.

New commands

• getlark jobs create --name <name> --input-file <path> — create a job from an inline JSON input file (sent as application/json).
• getlark jobs upload --name <name> --file <path> — create a job by uploading an input file as multipart/form-data to /jobs/upload. The original filename is preserved on the job and visible from jobs get.
• getlark jobs validate --file <path> — validate an input file against the job's schema without creating a job. Exits non-zero when the report's valid: false.
• getlark jobs list [--limit] [--offset] [--status …] — list jobs, with a repeatable --status filter (pending, running, completed, failed, cancelled).
• getlark jobs get <job_id> — fetch a job's full JSON, including the new dashboard_url field.
• getlark jobs cancel <job_id> — cancel a pending or running job.

All commands accept --type, currently fixed to workflow_import (the only supported job type).

workflow_import input schema

The same JSON file is accepted by jobs create, jobs upload, and jobs validate:

​json { "workflows": [ { "name": "Checkout smoke", "description": "Verify checkout works end-to-end with a test card.", "mode": "ai_driven", "secret_contexts": ["staging"], "group_id": "wgrp_01h..." } ] } ​

mode is "ai_driven" or "deterministic"; secret_contexts and group_id are optional. No additional properties are accepted.

API client changes

• GetLarkClient gained createJob, listJobs, getJob, cancelJob, uploadJob, and validateUploadJob methods (see src/api/client.ts).
• The internal request layer now supports FormData bodies (boundary is set automatically by fetch) and repeated query params (used for multi-value status filters).
• New types in src/api/types.ts: JobType, JobStatus, JobResource (includes the new required dashboard_url), ListJobsResponse, WorkflowImportInput, CreateJobRequest, JobValidationReport, and JobValidationMessage.

Docs & misc

• README has a full jobs section covering every subcommand, the input schema, and recommended validate-before-create workflow.
• .gitignore now excludes local-testing/ for ad-hoc CLI sample inputs.

Compatibility

• No breaking changes to existing workflows, workflow-groups, secret-contexts, login, logout, or config commands.
• Still requires Node.js ≥ 18 and uses the same X-API-Key auth and ~/.getlark/config.json profile store as 0.4.x.

v0.4.2

What's Changed

• publish to npm by @jackcbrown89 in #2

Full Changelog: 0.4.1...v0.4.2