agentlinkops index submissions-import

agentlinkops index submissions-import FILE

Behavior and output

Imports an array of up to 100 caller-supplied submission receipts into .agentlinkops/index-submissions.jsonl. The paths.indexSubmissions configuration field can change this location. Input and stored files are capped at 32 MiB. A writer lock protects an atomic merge. The pair project_id and id identifies one immutable attempt: identical replays keep one record; changed content conflicts. Use a new ID for each actual attempt. The command makes no network requests and sends no URL submissions.

Receipt schema

Every row must contain exactly these nine fields. Extra fields, including credentials, are rejected.

Field	Required value
`v`	Integer `1`
`id`	One to 128 ASCII letters, digits, underscores or hyphens
`project_id`	Same character and length rules as `id`; the project whose observations will be compared
`url`	Exact HTTP(S) URL in JavaScript `new URL(value).href` form; no credentials or fragment
`channel`	`indexnow`
`endpoint`	`https://api.indexnow.org/indexnow`; other endpoints are outside this import contract
`submitted_at`	Valid UTC ISO timestamp with milliseconds, such as `2026-09-20T12:00:00.000Z`
`http_status`	Integer from 100 through 599, or `null` for an unknown transport outcome
`evidence_sha256`	Lowercase SHA256 hex digest of the canonical receipt fields described below

For hashing, construct an object in this exact insertion order: v, id, project_id, url, channel, endpoint, submitted_at, http_status. Hash the UTF-8 bytes of JSON.stringify(body) with no pretty printing or trailing newline. Exclude evidence_sha256 from the hash. JSON field order in the imported file may differ; validation reconstructs the stated order. The digest checks local integrity. It does not authenticate the provider or prove the request happened. Retain actual response evidence in your own records; do not invent timestamps or responses. Never put an IndexNow key, authorization header or request body in this file.

Build an illustrative import file

Save this as make-submission.mjs and run node make-submission.mjs. This example sends nothing and records no actual provider result. Replace its example values with a response you retained before using it as evidence.

import { createHash } from 'node:crypto';
import { writeFileSync } from 'node:fs';

// Illustrative receipt only. Replace with your actual recorded response.
const body = {
  v: 1,
  id: 'submission-example-001',
  project_id: 'pr_example',
  url: 'https://example.com/article/',
  channel: 'indexnow',
  endpoint: 'https://api.indexnow.org/indexnow',
  submitted_at: '2026-09-20T12:00:00.000Z',
  http_status: 202,
};
const evidence_sha256 = createHash('sha256')
  .update(JSON.stringify(body), 'utf8').digest('hex');
writeFileSync('submissions.json', JSON.stringify([{ ...body, evidence_sha256 }], null, 2));

agentlinkops index submissions-import submissions.json
agentlinkops index submissions-export --project-id pr_example
agentlinkops index reconcile-submissions --project-id pr_example

A successful import prints imported (input row count, including replays) and total (all stored projects). Read submission exports for a project-filtered archive and chronological reconciliation for later observations. Existing index receipt import supplies the separate observation archive.

Arguments

FILE: JSON array of up to 100 receipts. No command-specific options.

Exit status

0 on success; 2 on invalid input, receipt conflict, configuration or file failure. Read configuration and file ownership before automating this command. Read local file contracts for artifact fields. Browse the local command index for related commands.

Check the selected environment and workspace access before calling hosted operations. See capability status.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

agentlinkops index submissions-import

Behavior and output

Receipt schema

Build an illustrative import file

Arguments

Exit status

​Behavior and output

​Receipt schema

​Build an illustrative import file

​Arguments

​Exit status

Behavior and output

Receipt schema

Build an illustrative import file

Arguments

Exit status