manage_supplier_document_evidence
Create and maintain controlled supplier document evidence for Kiln designs by ingesting revisions, listing history, retrieving document text, and tracking evidence cases.
Instructions
Create and maintain controlled supplier evidence (Business+).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_supplier_document_evidence"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which operation to run: ``ingest_revision``, ``list_history``, ``get_document_text``, ``create_case`` or ``case_status`` (case-insensitive). Anything else is refused with ``INVALID_ACTION``. | |
| region | No | ``ingest_revision`` only: the region the document applies to; part of the document's identity. Omitted, it is ``global``. Default: "global". | |
| purpose | No | ``create_case`` only: a short label for what the evidence supports; it must contain letters or numbers. Omitted, it is ``conformal_coating``. Default: "conformal_coating". | |
| language | No | ``ingest_revision`` only: the document's language; part of the document's identity. Omitted, it is ``en``. Default: "en". | |
| bom_items | No | ``create_case`` only, optional: a BOM snapshot the caller supplies, recorded as operator-attested. Used only when no ``manual_id`` BOM is bound. | |
| design_id | No | ``create_case`` only, required: the Kiln design the case is about. Default: "". | |
| manual_id | No | ``create_case`` only, optional: a Kiln assembly manual for this design version whose generated BOM is bound to the case. Default: "". | |
| created_by | No | Optional caller-supplied case-author label. Kiln records it as unverified rather than authenticated identity. Default: "". | |
| issue_date | No | ``ingest_revision`` only, optional: the issue date as an ISO date (``YYYY-MM-DD``); any other format is refused. Recorded as caller-asserted, not verified. Default: "". | |
| source_url | No | ``ingest_revision`` only, optional: where the document was obtained, recorded with the revision. Kiln does not fetch or watch it. Default: "". | |
| document_id | No | ``list_history`` only: the document whose revisions to list. May be omitted when ``document_revision_id`` is given; if both are given they must name the same document. Default: "". | |
| reviewed_by | No | Optional caller-supplied reviewer label. Kiln records it as unverified rather than authenticated identity. Default: "". | |
| product_form | No | ``ingest_revision`` only, optional: the product's form as the operator classifies it. It is part of the document's identity, so different forms are separate documents. Default: "". | |
| product_name | No | ``ingest_revision`` only, required: the product as the document names it, verified the same way as ``supplier_name``. Default: "". | |
| document_text | No | ``ingest_revision`` only, required: the full text of the supplier document. Kiln stores this exact text and its digest; empty, control-character or oversized text is refused. Default: "". | |
| document_type | No | ``ingest_revision`` only, required: one of the supported types listed above. Any other value is refused with ``INVALID_DOCUMENT_TYPE``. Default: "". | |
| supplier_name | No | ``ingest_revision`` only, required: the supplier as the document names it. It must appear inside its ``identity_spans`` span, which must be verbatim in the text. Default: "". | |
| identity_spans | No | ``ingest_revision`` only: a mapping from identity field (``supplier_name``, ``product_name``, ``revision_label``, optionally ``document_type`` and ``lot_identifier``) to text quoted verbatim from ``document_text``. | |
| lot_identifier | No | ``ingest_revision`` only, optional: the manufacturing lot or batch this document covers (certificates of conformance, lot test reports). When given it must appear verbatim in ``document_text`` and ``identity_spans.lot_identifier`` must quote that span; it becomes part of the document's identity, so certificates for different lots coexist. Leave it empty for living documents (TDS, SDS). Default: "". | |
| revision_label | No | ``ingest_revision`` only, required: the supplier's own revision label, verified against its span. A label already stored with different content is refused unless ``review_acknowledged`` and ``correction_reason`` are given. Default: "". | |
| source_filename | No | ``ingest_revision`` only, optional: the name of the file the text came from, recorded with the revision. Default: "". | |
| evidence_case_id | No | ``case_status`` only, required: the case to re-check. Default: "". | |
| correction_reason | No | ``ingest_revision`` only: why the content under an existing revision label is being corrected. Required, with ``review_acknowledged``, for that case; otherwise optional. Default: "". | |
| design_version_id | No | ``create_case`` only, required: the version of ``design_id`` the documents are attached to. Default: "". | |
| review_acknowledged | No | ``ingest_revision`` only: set ``True``, together with ``correction_reason``, to store new content under a revision label that already exists. Defaults to ``False``. Default: false. | |
| document_revision_id | No | ``list_history``: a revision whose document's history to list. ``get_document_text``, required: the revision whose stored text to return. Default: "". | |
| document_revision_ids | No | ``create_case`` only, required: the saved revisions to attach (duplicates are dropped). Each must exist and be active in Kiln; too few or too many is refused. | |
| supersedes_revision_id | No | ``ingest_revision`` only: the ``revision_id`` of the document's currently active revision. Required whenever one is active; any other id is refused. Default: "". | |
| currentness_attestations | No | Optional dated human checks keyed by attached ``revision_id``. Each object requires ``checked_on`` and ``basis`` and may include ``reviewed_by``. These establish an operator attestation, not automatic supplier monitoring or system-verified currentness. |