Skip to content

docs: which port the orchestrator's Import step reads - #15

Merged
makseq merged 1 commit into
mainfrom
docs/import-reads-output
Oct 14, 2026
Merged

makseq merged 1 commit into
mainfrom
docs/import-reads-output

Conversation

@makseq

@makseq makseq commented Oct 14, 2026

Copy link
Copy Markdown
Member

Documentation only.

The orchestrator's Import step — the step that turns a file into Label Studio tasks — now reads an upstream step's output with nothing configured, and has a built-in importer for Label Studio tasks JSON (orchestrator commit 8d8a5e2a, deployed 2026-10-13). A node author choosing port names needs to know that.

  • docs/PROTOCOL.md, section 8 — one BEHAVIOUR paragraph: Import reads the one artifact of kind source_data, else output; the node's "Upstream artifact kind" names another kind; it reads exactly one file and fails at once, naming them, when it finds two or more; the built-in ls_tasks_json importer takes one object or an array of objects, each the task data or a complete task with a data object.
  • docs/README.md — a routing-table pointer to that paragraph, and a provenance note: this one statement was held against handlers/steps/import_tasks.py and handlers/importers/ls_tasks_json.py at 8d8a5e2a (unchanged on master up to 1561fa1a); nothing else was rechecked.

Reviewed by Codex (gpt-6-astra, high) against the orchestrator code: clean.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XQDS15iYfpfCaTY6LoDx9e

Orchestrator commit 8d8a5e2a (deployed 2026-10-13) taught its Import step,
the one that turns a file into Label Studio tasks, to read an upstream
step's `output` with nothing configured, and added a built-in importer for
Label Studio tasks JSON. A node author deciding port names needs to know
that, so PROTOCOL section 8 now says it as BEHAVIOUR: the kinds read and
their order, the "Upstream artifact kind" override, the one-file rule, and
the file shape the built-in importer accepts.

Also a routing-table pointer to it, and a provenance note: this one
statement was held against the two orchestrator files at 8d8a5e2a (unchanged
up to master 1561fa1a); nothing else was rechecked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XQDS15iYfpfCaTY6LoDx9e
@makseq
makseq merged commit f87b286 into main Oct 14, 2026
1 check passed
@makseq
makseq deleted the docs/import-reads-output branch October 14, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant