Service job proof

Local HTTP jobs already make agentic deck production observable.

Paralleliz has a local HTTP job service today for agent-submitted render work. It is file-backed, observable through the TUI and local browser-console prototype, and ready for local automation pilots; hosted browser workspace management remains planned.

Run The Service See Agent Loop

Lifecycle

States match the backend API contract.

pending

Queued but not started.

Watch queue depth or cancel before execution.

running

Worker is loading, validating, explaining, or rendering.

Read events and wait for durable stage boundaries.

completed

Output and validation artifacts were written.

Download PPTX, manifest, validation report, and normalized data.

failed

Validation or rendering failed.

Inspect validation errors, event log, and submitted request.

cancelled

Cancelled before execution or at a safe boundary.

Resubmit after adjusting request or priority.

API fixture

Submit once, poll state, download artifacts.

Start service

uv run python visuals_service.py --host 127.0.0.1 --port 8765 --jobs-dir jobs --concurrency 2 --retention-days 14 --keep-last 25

Request

{
  "name": "Founder update batch",
  "requested_by": "deck_agent",
  "analysis_prompt": "Generate a management-ready deck from the monthly KPI packet.",
  "spec_path": "examples/story_auto.json",
  "force": false
}

Response

{
  "job_id": "20260827-092233-founder-update-batch-a1b2c3d4",
  "state": "pending",
  "progress": 0,
  "message": "queued",
  "links": {
    "status": "/jobs/20260827-092233-founder-update-batch-a1b2c3d4",
    "events": "/jobs/20260827-092233-founder-update-batch-a1b2c3d4/events",
    "artifacts": "/jobs/20260827-092233-founder-update-batch-a1b2c3d4/artifacts"
  }
}

Lifecycle fixture

Status, events, and artifact manifest proof.

This is a sanitized service-contract proof fixture, not a live browser console capture. Live local management exists through the HTTP API, TUI, and the local browser-console prototype; hosted workspace management remains planned.

Status response

{
  "job_id": "20260827-092233-founder-update-batch-a1b2c3d4",
  "state": "completed",
  "progress": 1,
  "message": "completed",
  "created_at": "2026-08-27T09:22:33-04:00",
  "updated_at": "2026-08-27T09:22:49-04:00",
  "request": {
    "name": "Founder update batch",
    "spec_path": "examples/story_auto.json",
    "requested_by": "deck_agent"
  },
  "artifacts_url": "/jobs/20260827-092233-founder-update-batch-a1b2c3d4/artifacts"
}

Events

[
  {
    "ts": "2026-08-27T09:22:33-04:00",
    "event": "queued",
    "message": "Job accepted and persisted."
  },
  {
    "ts": "2026-08-27T09:22:36-04:00",
    "event": "validation_completed",
    "message": "Source spec passed validation with review artifacts enabled."
  },
  {
    "ts": "2026-08-27T09:22:45-04:00",
    "event": "render_completed",
    "message": "PowerPoint deck and normalized artifacts written."
  },
  {
    "ts": "2026-08-27T09:22:49-04:00",
    "event": "completed",
    "message": "Job finished and artifact manifest is available."
  }
]

Artifact manifest

{
  "job_id": "20260827-092233-founder-update-batch-a1b2c3d4",
  "artifacts": [
    {
      "id": "request",
      "label": "Submitted request",
      "path": "request.json"
    },
    {
      "id": "events",
      "label": "Event log",
      "path": "events.jsonl"
    },
    {
      "id": "validation_report",
      "label": "Validation report",
      "path": "validation_report.json"
    },
    {
      "id": "outputs_manifest",
      "label": "Outputs manifest",
      "path": "outputs_manifest.json"
    },
    {
      "id": "output",
      "label": "PowerPoint deck",
      "path": "output.pptx"
    }
  ]
}

Outputs

Artifacts are concrete, downloadable, and audit-friendly.

The service writes job state, event logs, validation reports, normalized data, Excel summaries, manifests, and the final PowerPoint deck.

request.json

status.json

events.jsonl

outputs_manifest.json

validation_report.json

normalized/slide_001_bar.json

output_data/slide_001_bar.csv

output.pptx

job_summary.xlsx

Gaps

What must exist before a production browser console.

Current limits

The local browser-console prototype is available; it is not a hosted, authenticated, or shared team workspace.
Job listing has bounded cursor pagination and state filters; batch, archetype, date, and source filters remain to be added.
Artifact indexing is file-backed and should move to explicit metadata before cloud hosting.
Cancellation is honored before execution and between durable stages, not inside a PowerPoint render call.

Backend gaps

GET /jobs filters by state, batch, archetype, date, and source system.
Richer batch, archetype, date, and source-system job filters.
Measured token and provider-cost telemetry attached automatically to every job; batch totals currently aggregate caller estimates.

Truth in messaging

Sell Paralleliz as a local-first engine with HTTP automation and a local browser console today. Label hosted persistence, shared batch management, and team workspace features as planned until the backend contracts are implemented and tested.