lda.chat/lda-wf
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: expose authoring contract inventory

Browse Source
This commit is contained in:
lda
2026-08-14 15:44:04 +07:00 Verified
parent 0f1ed56876
commit 22510e0681
11 changed files with 713 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/wf_api/authoring_contracts.py
+30
View File
@@ -132,6 +132,36 @@ def project_authoring_contract_inventory(
}
def project_authoring_step_contract(
*,
step_id: str,
label: str,
description: str | None,
input_schema: JsonObject,
output_schema: JsonObject,
outcomes: Sequence[str],
) -> AuthoringStepContractPayload:
"""Project one resolved executable capability into authoring choices."""
payload: AuthoringStepContractPayload = {
"step_id": step_id,
"label": label,
"input_targets": schema_path_options(
input_schema,
root="step_input",
uses=["step_input"],
),
"output_sources": schema_path_options(
output_schema,
root="step_output",
uses=["step_output_source", "workflow_output"],
),
"outcomes": list(outcomes),
}
if description is not None:
payload["description"] = description
return payload
def context_path_options(
fields: Sequence[ContextFieldAvailability | Mapping[str, Any]],
) -> list[AuthoringPathOptionPayload]:
src/wf_api/service.py
+138 -2
View File
@@ -1,19 +1,27 @@
from __future__ import annotations
from collections.abc import Sequence
from collections.abc import Mapping, Sequence
from typing import Any
from wf_artifacts import ArtifactKind
from wf_artifacts import ArtifactKind, compile_workflow_draft
from wf_artifacts.drafts.models import DraftStep
from wf_core.analysis.context_scopes import context_analysis_warnings
from wf_core.models.steps import InputBinding, OutputBinding, StepInputBinding
from wf_core.models.workflow import Workflow
from .artifacts import WorkflowArtifactApi
from .authoring_contracts import (
context_path_options_for_node,
project_authoring_contract_inventory,
project_authoring_step_contract,
)
from .capabilities import WorkflowCapabilityApi
from .deployments import WorkflowDeploymentApi
from .draft_authoring import RouteSource, WorkflowDraftAuthoringApi
from .draft_updates import CapabilityStepUpdate
from .drafts import WorkflowDraftApi
from .models import (
AuthoringContractInventoryPayload,
CapabilityCallResult,
CompileDraftWorkspaceResult,
CompileDraftWorkspaceSuccess,
@@ -45,6 +53,25 @@ from .operation_context import WorkflowOperationContext
from .runs import TraceRangeLike, WorkflowRunApi
def _authoring_schema(value: object) -> dict[str, Any]:
"""Return a safe schema object from a possibly invalid persisted draft."""
return dict(value) if isinstance(value, Mapping) else {}
def _authoring_outcomes(value: object) -> list[str]:
"""Keep only a complete string outcome list for tolerant inventory output."""
if not isinstance(value, list) or not all(
isinstance(outcome, str) for outcome in value
):
return []
return list(value)
def _step_label(step_id: str) -> str:
"""Humanize a keyed draft step for compact executable choices."""
return step_id.replace("_", " ").replace("-", " ").title()
class WorkflowApi:
"""Protocol-neutral workflow application facade.
@@ -324,6 +351,115 @@ class WorkflowApi:
include_draft=include_draft,
)
async def inspect_draft_authoring_contract(
self,
*,
workspace_id: str,
revision: int,
selected_step_id: str | None = None,
) -> AuthoringContractInventoryPayload | DraftWorkspaceResult:
"""Inspect revision-scoped authoring choices without persisting changes.
The workspace revision check deliberately happens before interpreting a
selected step. This preserves the draft APIs' canonical conflict
precedence when an authoring client is holding an old revision.
"""
checked = self.drafts._workspace_if_revision_matches(
workspace_id=workspace_id,
revision=revision,
)
if isinstance(checked, dict):
return checked
draft = checked.draft
raw_steps = draft.get("steps")
steps = raw_steps if isinstance(raw_steps, Mapping) else {}
if selected_step_id is not None and selected_step_id not in steps:
raise KeyError(f"unknown draft step {selected_step_id!r}")
warnings: list[str] = []
entry_steps = []
selected_contract = None
for raw_step_id, raw_step in steps.items():
if not isinstance(raw_step_id, str) or raw_step_id == "__end__":
continue
if not isinstance(raw_step, Mapping):
continue
capability_name = raw_step.get("use")
if not isinstance(capability_name, str):
if raw_step_id == selected_step_id:
warnings.append(
f"selected step {raw_step_id!r} is not an executable capability"
)
continue
try:
spec = self.context.specs.get_qualified_spec(capability_name)
input_schema = (
spec.input_schema_contract or spec.input_model.model_json_schema()
)
output_schema = (
spec.output_schema_contract or spec.output_model.model_json_schema()
)
except (KeyError, TypeError, ValueError) as exc:
if raw_step_id == selected_step_id:
warnings.append(
f"selected step {raw_step_id!r} cannot be interpreted: {exc}"
)
continue
description = raw_step.get("desc")
if not isinstance(description, str):
description = spec.description
contract = project_authoring_step_contract(
step_id=raw_step_id,
label=_step_label(raw_step_id),
description=description,
input_schema=input_schema,
output_schema=output_schema,
outcomes=spec.outcomes,
)
entry_steps.append(contract)
if raw_step_id == selected_step_id:
selected_contract = contract
context_entries = []
if selected_step_id is not None:
try:
compiled_plan = compile_workflow_draft(draft)
workflow = Workflow.model_validate(compiled_plan)
context_entries = context_path_options_for_node(
workflow,
selected_step_id,
)
warnings.extend(context_analysis_warnings(workflow))
except (KeyError, TypeError, ValueError) as exc:
warnings.append(
f"runtime context unavailable for selected step "
f"{selected_step_id!r}: {exc}"
)
selected_input_targets = []
selected_output_sources = []
if selected_contract is not None and selected_step_id is not None:
if selected_contract["step_id"] == selected_step_id:
selected_input_targets = selected_contract.get("input_targets", [])
selected_output_sources = selected_contract.get("output_sources", [])
return project_authoring_contract_inventory(
workspace_id=workspace_id,
revision=checked.revision,
selected_step_id=selected_step_id,
input_schema=_authoring_schema(draft.get("input_schema")),
state_schema=_authoring_schema(draft.get("state_schema")),
output_schema=_authoring_schema(draft.get("output_schema")),
context_entries=context_entries,
step_input_targets=selected_input_targets,
step_output_sources=selected_output_sources,
entry_steps=entry_steps,
workflow_outcomes=_authoring_outcomes(draft.get("outcomes")),
warnings=warnings,
)
async def delete_draft_workspace(
self,
*,
src/wf_api/surface.py
+9
View File
@@ -11,6 +11,7 @@ from .draft_authoring import RouteSource
from .draft_updates import CapabilityStepUpdate
from .models import (
ApplyRegistryChangesResult,
AuthoringContractInventoryPayload,
AuthRecordSummaryPayload,
CapabilityCallResult,
CompileDraftWorkspaceResult,
@@ -107,6 +108,14 @@ class WorkflowDraftSurface(Protocol):
include_draft: bool = False,
) -> DraftWorkspaceResult: ...
async def inspect_draft_authoring_contract(
self,
*,
workspace_id: str,
revision: int,
selected_step_id: str | None = None,
) -> AuthoringContractInventoryPayload | DraftWorkspaceResult: ...
async def create_draft_workspace_from_capability(
self,
*,
src/wf_transport_rpc_http/client/drafts.py
+20
View File
@@ -5,6 +5,7 @@ from typing import Any, Literal, cast
from wf_api import CapabilityStepUpdate
from wf_api.models import (
AuthoringContractInventoryPayload,
CompileDraftWorkspaceResult,
CreateArtifactFromWorkspaceResult,
CreateDraftWorkspaceFromCapabilityResult,
@@ -76,6 +77,25 @@ class RpcDraftClientMixin:
{"workspace_id": workspace_id, "include_draft": include_draft},
)
async def inspect_draft_authoring_contract(
self: RpcCaller,
*,
workspace_id: str,
revision: int,
selected_step_id: str | None = None,
) -> AuthoringContractInventoryPayload | DraftWorkspaceResult:
return cast(
AuthoringContractInventoryPayload | DraftWorkspaceResult,
await self._call(
"workflow.draft_workspaces.inspect_authoring_contract",
{
"workspace_id": workspace_id,
"revision": revision,
"selected_step_id": selected_step_id,
},
),
)
async def create_draft_workspace_from_capability(
self: RpcCaller,
*,
src/wf_transport_rpc_http/methods/drafts.py
+18
View File
@@ -7,6 +7,7 @@ while registering nested handlers for response validation and OpenRPC output.
import fastapi_jsonrpc as jsonrpc
from wf_api.models import (
AuthoringContractInventoryPayload,
CompileDraftWorkspaceResult,
CreateArtifactFromWorkspaceResult,
CreateDraftWorkspaceFromCapabilityResult,
@@ -33,6 +34,7 @@ from ..models import (
DeleteDraftWorkspaceParams,
GetDraftWorkspaceParams,
HandleDraftParams,
InspectDraftAuthoringContractParams,
ListDraftWorkspacesParams,
PatchDraftParams,
PatchDraftWorkspaceParams,
@@ -113,6 +115,22 @@ def register_methods(
except (ValueError, KeyError, LookupError, FileNotFoundError) as exc:
raise_workflow_rpc_error(exc)
@entrypoint.method(
name="workflow.draft_workspaces.inspect_authoring_contract",
errors=[WorkflowRpcError],
)
async def workflow_draft_workspaces_inspect_authoring_contract(
params: InspectDraftAuthoringContractParams = RpcParams(),
) -> AuthoringContractInventoryPayload | DraftWorkspaceResult:
try:
return await server.api.inspect_draft_authoring_contract(
workspace_id=params.workspace_id,
revision=params.revision,
selected_step_id=params.selected_step_id,
)
except (ValueError, KeyError, LookupError, FileNotFoundError) as exc:
raise_workflow_rpc_error(exc)
@entrypoint.method(
name="workflow.draft_workspaces.create_from_capability",
errors=[WorkflowRpcError],
src/wf_transport_rpc_http/models.py
+6
View File
@@ -147,6 +147,12 @@ class GetDraftWorkspaceParams(RpcParamsModel):
include_draft: bool = False
class InspectDraftAuthoringContractParams(RpcParamsModel):
workspace_id: str = Field(min_length=1)
revision: int = Field(ge=1)
selected_step_id: str | None = Field(default=None, min_length=1)
class PatchDraftWorkspaceParams(RpcParamsModel):
workspace_id: str = Field(min_length=1)
revision: int = Field(ge=1)