agent-lifecycle-kit 1.88.0__tar.gz → 2.0.0__tar.gz

{agent_lifecycle_kit-1.88.0/src/agent_lifecycle_kit.egg-info → agent_lifecycle_kit-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-lifecycle-kit
-Version: 1.88.0
+Version: 2.0.0
 Summary: Provider-neutral lifecycle control layer that helps coding agents plan, execute, validate, and prove software tasks to completion.
 Author: Agent Lifecycle Kit contributors
 License: Apache-2.0
@@ -43,7 +43,7 @@ ALK provides a verifiable finish for external-agent work with proportionate cont
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==1.88.0`, and common `agent-lifecycle version` errors.
+It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.0.0`, and common `agent-lifecycle version` errors.
 
 For a quick start, run:
 
@@ -68,7 +68,7 @@ agent-lifecycle start --adapter <adapter-id> --file task.md
 - The boundaries of [planning-only launch](docs/reference/planning-only-launch.md) and [frozen-task launch through a verified profile](docs/reference/qualified-host-launch.md) are documented in the reference. Shipped planning profiles remain candidates with safe failure until the corresponding profile is verified.
 - The [system architecture](docs/architecture/system-architecture.md) page explains how the project is organized, and [project comparison](docs/reference/project-comparison.md) shows how it differs from similar tools.
 - Multiple-agent boundaries, workflow configuration, model choice, prompts, timeouts and retries are described in [workflow customization and execution controls](docs/reference/workflow-customization.md).
-- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
+- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
 - For long sessions, use [context checkpoints and compaction recovery](docs/reference/context-checkpoints.md). They preserve a bounded local continuation package without changing plan authority.
 ## What it gives you
 - A finish-oriented lifecycle: plan, execute, review, and prove the result.
@@ -187,8 +187,9 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Public release claims use tracked source files and redacted evidence summaries.
 - External dialect imports and retrieved episodes enrich context, while reviewed
   ALK artifacts remain the source of truth.
-- Cross-check, Review Mesh and runner recovery receipts add evidence when a task
-  or plan enables them; the operator chooses the review depth.
+- Cross-check, Review Mesh and historical runner recovery receipts add evidence
+  when a task or plan enables them; legacy runner records are converted
+  read-only and the operator chooses the review depth.
 
 ## Documentation
 
@@ -196,7 +197,6 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Planning and adapters: [Issue to specification drafts](docs/guides/issue-to-spec.md), [Adapter install](docs/adapters/install.md), and [Adapter support matrix](docs/adapters/support-matrix.md).
 - Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.md), [Plan verification](docs/reference/plan-verification.md), [Research evidence](docs/reference/research-evidence.md), [Public locators and redaction](docs/reference/public-locators-and-redaction.md), [Finding-to-check adoption](docs/reference/finding-check-adoption.md), [Source of truth](docs/reference/source-of-truth.md), [Managed lifecycle runner](docs/reference/managed-lifecycle-runner.md), [Managed adapter sessions](docs/reference/managed-adapter-sessions.md), [Portable Agent Plugins](docs/reference/agent-plugins.md), [Plugin publication](docs/reference/plugin-publication.md), [Implementation audit](docs/reference/implementation-audit.md), [Plan completeness](docs/reference/plan-completeness.md), [Public contracts](docs/reference/public-contracts.md), and [Readiness diagnostics](docs/reference/readiness-diagnostics.md).
 - Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
-- Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner recovery](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
+- Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner migration](docs/guides/runner-migration-2.md), [Runner recovery records](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
 - Release assets: [Task templates](templates/tasks/README.md), [Neutrality scanning](docs/reference/neutrality.md), and [Release security](docs/security/release-security.md).
-
 Apache-2.0. See [LICENSE](LICENSE).

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/README.md

@@ -21,7 +21,7 @@ ALK provides a verifiable finish for external-agent work with proportionate cont
 ## Quick start
 Start with [install ALK and make the first run](docs/guides/install-and-first-run.md).
 
-It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==1.88.0`, and common `agent-lifecycle version` errors.
+It includes macOS, Linux and Windows instructions, Python 3.11-3.14, [PyPI](https://pypi.org/project/agent-lifecycle-kit/) installation with `python -m pip install agent-lifecycle-kit==2.0.0`, and common `agent-lifecycle version` errors.
 
 For a quick start, run:
 
@@ -46,7 +46,7 @@ agent-lifecycle start --adapter <adapter-id> --file task.md
 - The boundaries of [planning-only launch](docs/reference/planning-only-launch.md) and [frozen-task launch through a verified profile](docs/reference/qualified-host-launch.md) are documented in the reference. Shipped planning profiles remain candidates with safe failure until the corresponding profile is verified.
 - The [system architecture](docs/architecture/system-architecture.md) page explains how the project is organized, and [project comparison](docs/reference/project-comparison.md) shows how it differs from similar tools.
 - Multiple-agent boundaries, workflow configuration, model choice, prompts, timeouts and retries are described in [workflow customization and execution controls](docs/reference/workflow-customization.md).
-- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
+- Create a local project profile with `agent-lifecycle project profile init`; see [project workflow profile](docs/reference/project-workflow-profile.md). Explain the selected profile, plan constraints and adapter capability lineage with [effective configuration](docs/reference/effective-configuration.md), [structured result qualification](docs/reference/structured-result-qualification.md) and [adapter action evidence](docs/reference/adapter-action-evidence.md). Add optional project-owned architecture and dependency evidence with [external verification checks](docs/reference/external-verification-checks.md).
 - For long sessions, use [context checkpoints and compaction recovery](docs/reference/context-checkpoints.md). They preserve a bounded local continuation package without changing plan authority.
 ## What it gives you
 - A finish-oriented lifecycle: plan, execute, review, and prove the result.
@@ -165,8 +165,9 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Public release claims use tracked source files and redacted evidence summaries.
 - External dialect imports and retrieved episodes enrich context, while reviewed
   ALK artifacts remain the source of truth.
-- Cross-check, Review Mesh and runner recovery receipts add evidence when a task
-  or plan enables them; the operator chooses the review depth.
+- Cross-check, Review Mesh and historical runner recovery receipts add evidence
+  when a task or plan enables them; legacy runner records are converted
+  read-only and the operator chooses the review depth.
 
 ## Documentation
 
@@ -174,7 +175,6 @@ Adapter installation and support-level details live in [Adapter install](docs/ad
 - Planning and adapters: [Issue to specification drafts](docs/guides/issue-to-spec.md), [Adapter install](docs/adapters/install.md), and [Adapter support matrix](docs/adapters/support-matrix.md).
 - Reference: [System architecture](docs/architecture/system-architecture.md), [workflow customization and execution controls](docs/reference/workflow-customization.md), [execution strategy](docs/reference/execution-strategy.md), [CLI reference](docs/reference/cli.md), [External verification checks](docs/reference/external-verification-checks.md), [Plan verification](docs/reference/plan-verification.md), [Research evidence](docs/reference/research-evidence.md), [Public locators and redaction](docs/reference/public-locators-and-redaction.md), [Finding-to-check adoption](docs/reference/finding-check-adoption.md), [Source of truth](docs/reference/source-of-truth.md), [Managed lifecycle runner](docs/reference/managed-lifecycle-runner.md), [Managed adapter sessions](docs/reference/managed-adapter-sessions.md), [Portable Agent Plugins](docs/reference/agent-plugins.md), [Plugin publication](docs/reference/plugin-publication.md), [Implementation audit](docs/reference/implementation-audit.md), [Plan completeness](docs/reference/plan-completeness.md), [Public contracts](docs/reference/public-contracts.md), and [Readiness diagnostics](docs/reference/readiness-diagnostics.md).
 - Quality and resources: [Reference-task evaluation](docs/reference/reference-task-evaluation.md), [model routing](docs/reference/model-routing.md), [quality-cost learning](docs/reference/quality-cost-learning.md), [performance and resource budgets](docs/reference/performance-and-resource-budgets.md), [lifecycle cost accounting](docs/reference/lifecycle-cost.md), [host-local token accounting](docs/reference/host-local-token-accounting.md), [process execution observability](docs/reference/process-execution-observability.md), [Usage export](docs/reference/usage-export.md), and [Evidence integrity](docs/reference/evidence-integrity.md).
-- Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner recovery](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
+- Profiles and operations: [Project workflow presets](docs/reference/workflow-presets.md), [Project workflow profile](docs/reference/project-workflow-profile.md), [Read-only status views](docs/reference/read-only-status-view.md), [Adapter progress bridge](docs/reference/automatic-progress-bridge.md), [Sandbox boundaries](docs/reference/sandbox-boundaries.md), [Import mappers](docs/reference/import-mappers.md), [Episode retrieval](docs/reference/episode-retrieval.md), [Runner migration](docs/guides/runner-migration-2.md), [Runner recovery records](docs/reference/runner-recovery.md), [Cross-check profile](docs/reference/cross-check-profile.md), [Review Mesh](docs/reference/review-mesh.md), [Bug Forensics profile](docs/reference/bug-forensics.md), and [Bug Forensics context budget](docs/reference/bug-forensics-context-budget.md).
 - Release assets: [Task templates](templates/tasks/README.md), [Neutrality scanning](docs/reference/neutrality.md), and [Release security](docs/security/release-security.md).
-
 Apache-2.0. See [LICENSE](LICENSE).

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/benchmarks/reference-tasks/manifest.json

@@ -3,11 +3,11 @@
   "suiteId": "alk-core-reference",
   "suiteVersion": "1.0.0",
   "tasks": [
-    {"id": "rt01-planning", "version": "1.0.0", "family": "planning", "tier": "S0", "shape": "planning", "taskPath": "rt01-planning/task.md", "oraclePath": "rt01-planning/oracle.json"},
-    {"id": "rt02-architecture-review", "version": "1.0.0", "family": "architecture-review", "tier": "S2", "shape": "review", "taskPath": "rt02-architecture-review/task.md", "oraclePath": "rt02-architecture-review/oracle.json"},
-    {"id": "rt03-bug-forensics", "version": "1.0.0", "family": "bug-forensics", "tier": "S1", "shape": "investigation", "taskPath": "rt03-bug-forensics/task.md", "oraclePath": "rt03-bug-forensics/oracle.json"},
-    {"id": "rt04-s1-managed-task", "version": "1.0.0", "family": "s1-managed-task", "tier": "S1", "shape": "implementation", "taskPath": "rt04-s1-managed-task/task.md", "oraclePath": "rt04-s1-managed-task/oracle.json"},
-    {"id": "rt05-s2-evidence-task", "version": "1.0.0", "family": "s2-evidence-task", "tier": "S2", "shape": "evidence", "taskPath": "rt05-s2-evidence-task/task.md", "oraclePath": "rt05-s2-evidence-task/oracle.json"}
+    {"id": "rt01-planning", "version": "1.0.0", "family": "planning", "tier": "S0", "shape": "planning", "taskPath": "rt01-planning/task.md", "oraclePath": "rt01-planning/oracle.json", "structuredResult": {"operationId": "reference-evaluation", "requiredModes": ["JSON_ENFORCED", "VALIDATED_TEXT"], "fixtureClasses": ["positive", "boundary", "malformed"]}},
+    {"id": "rt02-architecture-review", "version": "1.0.0", "family": "architecture-review", "tier": "S2", "shape": "review", "taskPath": "rt02-architecture-review/task.md", "oraclePath": "rt02-architecture-review/oracle.json", "structuredResult": {"operationId": "reference-evaluation", "requiredModes": ["SCHEMA_ENFORCED", "JSON_ENFORCED"], "fixtureClasses": ["positive", "boundary", "malformed"]}},
+    {"id": "rt03-bug-forensics", "version": "1.0.0", "family": "bug-forensics", "tier": "S1", "shape": "investigation", "taskPath": "rt03-bug-forensics/task.md", "oraclePath": "rt03-bug-forensics/oracle.json", "structuredResult": {"operationId": "reference-evaluation", "requiredModes": ["JSON_ENFORCED", "VALIDATED_TEXT"], "fixtureClasses": ["positive", "boundary", "malformed"]}},
+    {"id": "rt04-s1-managed-task", "version": "1.0.0", "family": "s1-managed-task", "tier": "S1", "shape": "implementation", "taskPath": "rt04-s1-managed-task/task.md", "oraclePath": "rt04-s1-managed-task/oracle.json", "structuredResult": {"operationId": "reference-evaluation", "requiredModes": ["SCHEMA_ENFORCED", "JSON_ENFORCED"], "fixtureClasses": ["positive", "boundary", "malformed"]}},
+    {"id": "rt05-s2-evidence-task", "version": "1.0.0", "family": "s2-evidence-task", "tier": "S2", "shape": "evidence", "taskPath": "rt05-s2-evidence-task/task.md", "oraclePath": "rt05-s2-evidence-task/oracle.json", "structuredResult": {"operationId": "reference-evaluation", "requiredModes": ["SCHEMA_ENFORCED", "JSON_ENFORCED"], "fixtureClasses": ["positive", "boundary", "malformed"]}}
   ],
   "productionPromotionClaimed": false
 }

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-lifecycle-kit"
-version = "1.88.0"
+version = "2.0.0"
 description = "Provider-neutral lifecycle control layer that helps coding agents plan, execute, validate, and prove software tasks to completion."
 readme = "README.md"
 requires-python = ">=3.11,<3.15"

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/src/agent_lifecycle/_version.py

@@ -1,3 +1,3 @@
 """Package version."""
 
-__version__ = "1.88.0"
+__version__ = "2.0.0"

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/src/agent_lifecycle/adapter_sessions/qualification.py

@@ -8,11 +8,15 @@ from typing import Any
 
 from agent_lifecycle.contracts import LifecycleError, canonical_digest, read_json_object, write_json_create
 from agent_lifecycle.contracts.launch_qualification import (
-    QUALIFICATION_POLICY_SCHEMA,
     QUALIFICATION_RECEIPT_SCHEMA,
-    QUALIFIED_PROFILE_STATUS,
     validate_qualification_policy,
 )
+from agent_lifecycle.contracts.structured_result_schemas import (
+    STRUCTURED_RESULT_SELECTION_SCHEMA,
+    build_structured_result_capability,
+    select_structured_result_mode,
+    validate_structured_result_selection,
+)
 from agent_lifecycle.contracts.validation import load_bounded_literal_profile
 
 _VERSION = re.compile(r"(?<![0-9])([0-9]+\.[0-9]+\.[0-9]+)(?![0-9])")
@@ -43,7 +47,6 @@ def load_shipped_launch_profile(adapter_id: str, *, repository_root: Path | None
         raise LifecycleError("qualified-launch-adapter-invalid", "adapter id is invalid")
     root = (repository_root or Path.cwd()).resolve()
     adapter_root = root / "adapters" / adapter_id
-    path = adapter_root / "launch_profile.py"
     profile = load_bounded_literal_profile(
         Path("launch_profile.py"),
         root=adapter_root,
@@ -75,10 +78,7 @@ def build_qualification_receipt(
     policy = profile.get("qualification")
     if not isinstance(policy, dict):
         raise LifecycleError("qualified-launch-policy-missing", "profile does not require qualification")
-    combined = "\n".join(
-        str(probe_receipt.get(stream, {}).get("tail", ""))
-        for stream in ("stdout", "stderr")
-    )
+    combined = "\n".join(str(probe_receipt.get(stream, {}).get("tail", "")) for stream in ("stdout", "stderr"))
     match = _VERSION.search(combined)
     actual = match.group(1) if match else None
     expected = policy.get("expectedVersion")
@@ -88,7 +88,9 @@ def build_qualification_receipt(
     if actual is None:
         blockers.append({"code": "qualified-launch-version-missing"})
     elif actual != expected:
-        blockers.append({"code": "qualified-launch-version-mismatch", "expectedVersion": expected, "actualVersion": actual})
+        blockers.append(
+            {"code": "qualified-launch-version-mismatch", "expectedVersion": expected, "actualVersion": actual}
+        )
     body = {
         "schemaVersion": QUALIFICATION_RECEIPT_SCHEMA,
         "status": "PASS" if not blockers else "FAIL",
@@ -139,13 +141,17 @@ def require_qualification_receipt(
         return None
     blockers = validate_qualification_policy(profile)
     if blockers:
-        raise LifecycleError("qualified-launch-policy-invalid", "qualification policy is invalid", {"blockers": blockers})
+        raise LifecycleError(
+            "qualified-launch-policy-invalid", "qualification policy is invalid", {"blockers": blockers}
+        )
     path = project_root.resolve() / ".alk" / "host-launch" / policy["receiptFile"]
     try:
         resolved = path.resolve(strict=True)
         resolved.relative_to((project_root.resolve() / ".alk" / "host-launch").resolve(strict=True))
     except (OSError, ValueError) as exc:
-        raise LifecycleError("qualified-launch-receipt-missing", "run host-launch preflight before managed launch") from exc
+        raise LifecycleError(
+            "qualified-launch-receipt-missing", "run host-launch preflight before managed launch"
+        ) from exc
     if path.is_symlink() or not path.is_file():
         raise LifecycleError("qualified-launch-receipt-path", "qualification receipt must be a regular file")
     receipt = read_json_object(path, label="host launch qualification receipt")
@@ -160,10 +166,17 @@ def require_qualification_receipt(
         "modelCallsStarted": False,
         "productionPromotionClaimed": False,
     }
-    if any(receipt.get(key) != value for key, value in expected.items()) or receipt.get("receiptDigest") != canonical_digest({k: v for k, v in receipt.items() if k != "receiptDigest"}):
-        raise LifecycleError("qualified-launch-receipt-invalid", "qualification receipt does not bind this profile and version")
+    if any(receipt.get(key) != value for key, value in expected.items()) or receipt.get(
+        "receiptDigest"
+    ) != canonical_digest({k: v for k, v in receipt.items() if k != "receiptDigest"}):
+        raise LifecycleError(
+            "qualified-launch-receipt-invalid", "qualification receipt does not bind this profile and version"
+        )
     if executable_identity is not None and receipt.get("executableIdentity") != executable_identity:
-        raise LifecycleError("qualified-launch-executable-identity-mismatch", "qualification receipt does not bind the current executable identity")
+        raise LifecycleError(
+            "qualified-launch-executable-identity-mismatch",
+            "qualification receipt does not bind the current executable identity",
+        )
     if receipt.get("blockers") != []:
         raise LifecycleError("qualified-launch-receipt-invalid", "qualification receipt contains blockers")
     return receipt
@@ -198,7 +211,13 @@ def require_planning_qualification_receipt(
         raise LifecycleError(
             "planning-launch-qualification-required",
             "planning launch is unsupported until exact-version live qualification passes",
-            {"preparationCommand": f"agent-lifecycle adapter launch-profile --adapter {profile.get('adapterId')} --out .alk/host-launch/{profile.get('adapterId')}.json"},
+            {
+                "preparationCommand": (
+                    "agent-lifecycle adapter launch-profile "
+                    f"--adapter {profile.get('adapterId')} "
+                    f"--out .alk/host-launch/{profile.get('adapterId')}.json"
+                )
+            },
         )
     receipt = require_qualification_receipt(
         project_root=project_root,
@@ -212,3 +231,122 @@ def require_planning_qualification_receipt(
             "local version receipt is not bound to qualified planning support",
         )
     return receipt
+
+
+def build_structured_result_qualification_receipt(
+    *,
+    operation_id: str,
+    adapter_id: str,
+    descriptor_digest: str,
+    host_version: str,
+    model_class: str,
+    required_mode: str,
+    required_schema_digest: str,
+    capability_manifest_digest: str,
+    capability_level: str,
+    evidence_digest: str,
+    measured_run_count: int,
+    plan_digest: str,
+    lock_digest: str,
+) -> dict[str, Any]:
+    """Build an advisory, operation-bound structured-result qualification receipt."""
+
+    capability = build_structured_result_capability(
+        operation_id=operation_id,
+        adapter_id=adapter_id,
+        descriptor_digest=descriptor_digest,
+        host_version=host_version,
+        model_class=model_class,
+        capability_level=capability_level,
+        qualification_status="QUALIFIED" if capability_level != "UNAVAILABLE" else "UNAVAILABLE",
+        capability_manifest_digest=capability_manifest_digest,
+        evidence_digest=evidence_digest,
+        measured_run_count=measured_run_count,
+    )
+    selection = select_structured_result_mode(
+        [capability],
+        operation_id=operation_id,
+        required_mode=required_mode,
+        adapter_id=adapter_id,
+        descriptor_digest=descriptor_digest,
+        host_version=host_version,
+        model_class=model_class,
+        capability_manifest_digest=capability_manifest_digest,
+        required_schema_digest=required_schema_digest,
+        lineage={"planDigest": plan_digest, "lockDigest": lock_digest},
+    )
+    body = {
+        "schemaVersion": "agent-structured-result-qualification-receipt.v1",
+        "status": "PASS" if selection["status"] == "PASS" else "UNAVAILABLE",
+        "qualificationStatus": "QUALIFIED" if selection["status"] == "PASS" else "UNAVAILABLE",
+        "operationId": operation_id,
+        "adapterId": adapter_id,
+        "descriptorDigest": descriptor_digest,
+        "hostVersion": host_version,
+        "modelClass": model_class,
+        "capabilityManifestDigest": capability_manifest_digest,
+        "requiredMode": required_mode,
+        "requiredSchemaDigest": required_schema_digest,
+        "planDigest": plan_digest,
+        "lockDigest": lock_digest,
+        "capability": capability,
+        "selection": selection,
+        "advisoryOnly": True,
+        "automaticRouteAdoptionEligible": False,
+        "modelCallsStarted": False,
+        "hostLaunchStarted": False,
+        "productionPromotionClaimed": False,
+    }
+    return {**body, "receiptDigest": canonical_digest(body)}
+
+
+def validate_structured_result_qualification_receipt(
+    receipt: dict[str, Any], *, expected: dict[str, Any] | None = None
+) -> dict[str, Any]:
+    """Validate structured-result qualification without granting workflow authority."""
+
+    blockers: list[dict[str, Any]] = []
+    if receipt.get("schemaVersion") != "agent-structured-result-qualification-receipt.v1":
+        blockers.append({"code": "structured-result-qualification-schema"})
+    if receipt.get("advisoryOnly") is not True or receipt.get("automaticRouteAdoptionEligible") is not False:
+        blockers.append({"code": "structured-result-qualification-authority"})
+    if receipt.get("modelCallsStarted") is not False or receipt.get("hostLaunchStarted") is not False:
+        blockers.append({"code": "structured-result-qualification-side-effect"})
+    for key, value in (expected or {}).items():
+        if receipt.get(key) != value:
+            blockers.append({"code": "structured-result-qualification-lineage", "field": key})
+    selection = receipt.get("selection")
+    if not isinstance(selection, dict):
+        blockers.append({"code": "structured-result-qualification-selection"})
+    else:
+        selection_validation = validate_structured_result_selection(
+            selection,
+            expected={
+                key: receipt.get(key)
+                for key in (
+                    "operationId",
+                    "adapterId",
+                    "descriptorDigest",
+                    "hostVersion",
+                    "modelClass",
+                    "capabilityManifestDigest",
+                    "requiredSchemaDigest",
+                )
+                if receipt.get(key) is not None
+            },
+        )
+        if selection_validation["status"] != "PASS":
+            blockers.append({"code": "structured-result-qualification-selection-invalid"})
+        if receipt.get("status") == "PASS" and selection.get("schemaVersion") != STRUCTURED_RESULT_SELECTION_SCHEMA:
+            blockers.append({"code": "structured-result-qualification-selection-schema"})
+    expected_digest = canonical_digest({key: value for key, value in receipt.items() if key != "receiptDigest"})
+    if receipt.get("receiptDigest") != expected_digest:
+        blockers.append({"code": "structured-result-qualification-digest"})
+    body = {
+        "schemaVersion": "agent-structured-result-qualification-validation.v1",
+        "status": "PASS" if not blockers else "FAIL",
+        "qualificationStatus": receipt.get("qualificationStatus"),
+        "blockers": blockers,
+        "productionPromotionClaimed": False,
+    }
+    return {**body, "validationDigest": canonical_digest(body)}

{agent_lifecycle_kit-1.88.0 → agent_lifecycle_kit-2.0.0}/src/agent_lifecycle/adapter_sessions/workflow_bridge.py

@@ -11,7 +11,7 @@ from agent_lifecycle.adapter_sessions.session_store import create_session, load_
 from agent_lifecycle.contracts import canonical_digest, read_json_object
 from agent_lifecycle.policy.risk_execution import derive_risk_execution_profile
 from agent_lifecycle.resources import builtin_profile_path
-from agent_lifecycle.workflow import run_managed_lifecycle_step
+from agent_lifecycle.workflow import run_workflow_step
 from agent_lifecycle.workflow.transition_contract import validate_action_catalog
 
 
@@ -35,7 +35,7 @@ def managed_adapter_run(
 ) -> dict[str, Any]:
     _descriptor_path, descriptor = load_adapter_descriptor(adapter_id, descriptor_path)
     profile = managed_launch_profile(descriptor)
-    runner_receipt = run_managed_lifecycle_step(
+    workflow_receipt = run_workflow_step(
         state_path=state_path,
         manifest_path=manifest_path,
         lock_path=lock_path,
@@ -44,8 +44,8 @@ def managed_adapter_run(
         source_revision=source_revision,
         reason=f"managed adapter run for {task_id}",
     )
-    next_action = runner_receipt.get("nextAction")
-    if runner_receipt["status"] == "PASS" and requested_risk is not None:
+    next_action = workflow_receipt.get("nextAction")
+    if workflow_receipt["status"] == "PASS" and requested_risk is not None:
         risk_profile = derive_risk_execution_profile(
             manifest=read_json_object(manifest_path, label="frozen plan manifest"),
             state=read_json_object(state_path, label="workflow state"),
@@ -84,7 +84,7 @@ def managed_adapter_run(
     session = create_session(
         adapter_id=adapter_id,
         mode="MANAGED_TASK",
-        status="READY" if runner_receipt["status"] == "PASS" else "BLOCKED",
+        status="READY" if workflow_receipt["status"] == "PASS" else "BLOCKED",
         launch_profile=profile,
         session_root=session_root,
         state_identity=state_identity,
@@ -100,7 +100,7 @@ def managed_adapter_run(
         managed_workflow_proof=proof,
         progress_hook_default="stderr",
         host_launch_started=False,
-        blockers=runner_receipt.get("blockers", []),
+        blockers=workflow_receipt.get("blockers", []),
         next_action=next_action,
     )