Skip to content

v0.20.5 — Assistant Service

Choose a tag to compare

View all tags
@JGabrielGruber JGabrielGruber released this 01 Jul 15:41
v0.20.5
fde04a9

[0.20.5] — 2026-07-01

0.20 release complete — migration guide, agent docs, verification.

Added

  • MIGRATION-0.20.md — assistant vs powertool migration for assist surfaces
  • RELEASE-0.20.5.md — release checklist and verify commands

Changed

  • docs/llms.txt — 0.20.5 agent rules (two view modes, typical session examples)
  • docs/MCP.md — palm_assist format param; link to MIGRATION-0.20.md
  • AGENTS.md — assistant/powertool conventions for MCP operators

[0.20.4] — 2026-07-01

palm_assist format default — assistant on assist paths; powertool on flows/system.

Added

  • palm_assist format param — default assistant; powertool / verbose opt-in
  • shape_dispatch_result + resolve_dispatch_format in assist MCP dispatch

Changed

  • Flows/system paths dispatched via palm_assist remain powertool regardless of tool default
  • REST assist dispatch forwards format query param when set

[0.20.3] — 2026-07-01

Assist session defaults — assistant envelope on service + REST; start returns first turn.

Changed

  • AssistSessionContext.to_dict — defaults to format=assistant; verbose and powertool opt-in
  • start_scenario — returns first assistant turn (question + choices), not ids-only
  • REST assist handlers — ?format=assistant|powertool|verbose on session routes
  • MCP assist dispatch — passthrough assistant envelopes (question field)

[0.20.2] — 2026-07-01

Assistant views — compose + humanize pipeline registered from assist domain.

Added

  • palm/services/assist/views.py — build_assistant_view, compose-always pipeline, humanized envelope
  • register_assistant_enricher on assist registry — per-scenario post-humanize hooks
  • OperatorViewContext.handoff_ready — assist handoff shaping
  • Tests — tests/test_assistant_view.py

Changed

  • AssistService — registers assistant view builder at construction

[0.20.1] — 2026-07-01

Operator view registry — thin format dispatch in common; powertool registered by default.

Added

  • palm/common/operator/view_registry.py — OperatorViewContext, register_operator_view_builder, build_operator_view, compact → powertool alias
  • Tests — tests/test_operator_view_registry.py

[0.20.0] — 2026-07-01

Design — Assistant vs Powertool operator view split (implementation 0.20.1–0.20.5).

Added

[0.19.1] — 2026-07-01

Bugfix — palm_assist compact shaping for in-process flow session dispatch.

Fixed

  • compact_dispatch_result — coerce SessionContext dataclass results to dicts before compact branching so palm_assist flow session inspect/input returns slim operator snapshots (not verbose result blobs)

[0.19.0] — 2026-07-01

Stable MCP proxy — single palm_assist dispatch tool for agent config stability.

Migration: MIGRATION-0.19.md · Vision: docs/VISION-0.18-ASSIST.md

Added

  • palm_assist MCP tool — parametric path / alias / params dispatch
  • palm://assist/routes — generated command-path catalog + contributor aliases
  • mcp_aliases on AssistContributor — stable alias map (operator-entry/start, etc.)
  • assist_dispatch on in-process and REST MCP backends
  • Tests — test_palm_assist_tool.py, test_assist_mcp_aliases.py

Changed

  • docs/MCP.md, docs/llms.txt — document palm_assist operator loop
  • Per-domain MCP tools (palm_flows_*, …) unchanged — migration optional

[0.18.0] — 2026-07-01

Assist domain MVP — fifth service for conversational operator guidance and handoff.

Migration: MIGRATION-0.18.md · Vision: docs/VISION-0.18-ASSIST.md

Added

  • palm/services/assist/ — AssistService, AssistSession, command registry, grammar
  • host.assist — wired on ApplicationHost and ServerContext
  • REST /v1/api/assist/… — scenarios, session verbs, doctor shortcut, handoff
  • palm-operator-entry — assist catalog scenario (examples/definitions/operator_entry.py)
  • palm/app/assist_registry.py — app-level assist contributor registry
  • OpenAPI Assist group — openapi_registry.py aggregates assist routes
  • Tests — test_assist_*, test_operator_entry_flow.py

Changed

  • INSTALLED_SERVICES — includes "assist"
  • STATUS.md, docs/MCP.md, docs/llms.txt, AGENTS.md — assist surface documented
  • ADR-006 — status Accepted

Notes

  • MCP unchanged in 0.18; stable palm_assist proxy deferred to 0.19
  • Assist wizards support existing step_kind: resource compositional steps

[0.17.3] — 2026-07-01

OpenAPI from service registries — /v1/openapi.json and /v1/docs document the full /v1/api/… surface.

Migration: MIGRATION-0.17.md · Plan: docs/superpowers/plans/2026-07-01-0.17-service-completion.md

Added

  • openapi_registry.py — aggregates per-service ROUTES into RouteDefinition metadata
  • tests/test_openapi_registry.py

Changed

  • openapi.py, docs.py, doc_examples.py — full service-domain route catalog
  • routes.py — registers meta routes only; service routes remain on service_routes.py
  • ARCHITECTURE.md — REST/OpenAPI layout note

Fixed

  • OpenAPI/HTML docs no longer meta-only after 0.17 monolith route removal

[0.17.2] — 2026-07-01

Palm provider remote alignment — compositional remote client uses /v1/api/… only.

Migration: MIGRATION-0.17.md

Changed

  • submit_flow_remote → POST /v1/api/flows/{flow_id}/create
  • get_job_remote → GET /v1/api/system/jobs/{job_id}
  • submit_process_remote → /v1/api/processes/{process_id}/prepare + /submit
  • remote_job_payload — maps session_id to instance_id

Documentation

  • docs/PROVIDER-APPS.md — remote binding path table

[0.17.1] — 2026-07-01

Process execution service — multi-flow runs under /v1/api/processes/…; legacy /v1/plans removed.

Migration: MIGRATION-0.17.md

Added

  • ProcessExecutionService — prepare, submit, run, dispatch with command-path grammar
  • REST — POST /v1/api/processes/{process_id}/prepare, /submit, /run
  • Registry — process_commands() in execution/processes/registry.py

Changed

  • PalmRestClient / in-process MCP — plan staging via /v1/api/processes/…
  • ServerContext — wires ProcessExecutionService with runtime for submit idle sync

Removed (breaking)

  • POST /v1/plans/prepare, POST /v1/plans/submit monolith routes

[0.17.0] — 2026-07-01

System REST parity — observe/lifecycle HTTP under /v1/api/system/…; legacy monolith job/instance/snapshot routes removed.

Migration: MIGRATION-0.17.md · Plan: docs/superpowers/plans/2026-07-01-0.17-service-completion.md

Added

  • System REST — inspect_job, cancel_job, list_instances, inspect_instance, instance_tree, snapshots, resume_instance on /v1/api/system/…
  • tests/test_system_service_routes.py, tests/test_rest_system_routes.py

Changed

  • PalmRestClient — waiting jobs, job context, cancel, tree, snapshots → /v1/api/system/…; provide_job_input delegates to flows session input
  • job_context.next_actions — flows session input + system instance/job paths
  • Wizard read model and invoke tree links → system service paths
  • Explorer SSR copy and doc examples updated

Removed (breaking)

  • GET/POST /v1/jobs monolith routes (submit → /v1/api/flows/{flow_id}/create; input → flows session)
  • /v1/instances, /v1/snapshots monolith routes
Assets 2
Loading