agent-workflow-contracts 1.0.0__tar.gz

agent_workflow_contracts-1.0.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: agent-workflow-contracts
+Version: 1.0.0
+Summary: Shared frozen wire contracts for agent workflows
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic
+Requires-Dist: hank-model-authority<2,>=1.6.1
+
+# agent_workflow_contracts
+
+Dependency-neutral frozen pydantic wire models shared by the gateway, the
+product agent runtimes, and any external consumer. No gateway imports —
+that is the point of the split.
+
+`AgentOperationSnapshot.execution_class` records the operation's work-kind.
+Optional `role` and `effort` declarations participate in its semantic identity;
+they do not resolve a model here. Both fields are omitted when `None`, preserving
+historical snapshot dumps and sealed admitted-task digests.
+
+`awaiting_approval` is an attempt settlement awaiting a human decision, not
+success or failure. It retains the exact admitted task identity, provenance,
+and observed usage, with a reason but no analytical outcome or result values.
+Executable approval binding and continuation belong to the gateway approval
+owner, not these wire contracts.
+
+| File | What it is |
+|---|---|
+| `models.py` | Frozen `WireModel` contracts including `CapabilityBind`, `AdmittedTask`, `TaskResult`, `DeliveryEnvelopeV1`/`V2`, `WorkflowView`, `PublishedOutput`, and `ContentHandle` |
+| `ticker_contract.py`, `research_file_contract.py` | the two typed identifier contracts |
+| `context_refs.py` | exact door-readback ref minter and declared-context renderer shared by pipeline stages and named children |
+| `schema.py` | `public_json_schemas()` / `public_schema_bundle()` / `export_public_json_schemas()` |
+| `generated/` | **build output** — JSON Schemas, `agent-workflow-contracts.d.ts`, the schema bundle, and delivery-envelope goldens. Regenerate from the checkout with `.venv/bin/python3 scripts/generate_agent_workflow_contracts.py`; do not hand-edit. |
+
+Consumers and lifecycle: `../../agent-gateway/docs/api-reference.md` (section "Workflow Delivery Contracts")
+The embedding application owns the workflow executor that admits and persists
+these contracts.

agent_workflow_contracts-1.0.0/agent_workflow_contracts/README.md

@@ -0,0 +1,28 @@
+# agent_workflow_contracts
+
+Dependency-neutral frozen pydantic wire models shared by the gateway, the
+product agent runtimes, and any external consumer. No gateway imports —
+that is the point of the split.
+
+`AgentOperationSnapshot.execution_class` records the operation's work-kind.
+Optional `role` and `effort` declarations participate in its semantic identity;
+they do not resolve a model here. Both fields are omitted when `None`, preserving
+historical snapshot dumps and sealed admitted-task digests.
+
+`awaiting_approval` is an attempt settlement awaiting a human decision, not
+success or failure. It retains the exact admitted task identity, provenance,
+and observed usage, with a reason but no analytical outcome or result values.
+Executable approval binding and continuation belong to the gateway approval
+owner, not these wire contracts.
+
+| File | What it is |
+|---|---|
+| `models.py` | Frozen `WireModel` contracts including `CapabilityBind`, `AdmittedTask`, `TaskResult`, `DeliveryEnvelopeV1`/`V2`, `WorkflowView`, `PublishedOutput`, and `ContentHandle` |
+| `ticker_contract.py`, `research_file_contract.py` | the two typed identifier contracts |
+| `context_refs.py` | exact door-readback ref minter and declared-context renderer shared by pipeline stages and named children |
+| `schema.py` | `public_json_schemas()` / `public_schema_bundle()` / `export_public_json_schemas()` |
+| `generated/` | **build output** — JSON Schemas, `agent-workflow-contracts.d.ts`, the schema bundle, and delivery-envelope goldens. Regenerate from the checkout with `.venv/bin/python3 scripts/generate_agent_workflow_contracts.py`; do not hand-edit. |
+
+Consumers and lifecycle: `../../agent-gateway/docs/api-reference.md` (section "Workflow Delivery Contracts")
+The embedding application owns the workflow executor that admits and persists
+these contracts.

agent_workflow_contracts-1.0.0/agent_workflow_contracts/__init__.py

@@ -0,0 +1,297 @@
+"""Dependency-neutral wire contracts for agent and workflow execution."""
+
+from .models import (
+  ActivityHandle,
+  AdmittedDataRef,
+  AdmittedInputBinding,
+  AdmittedPlanRef,
+  AdmittedTask,
+  AdmittedToolRoute,
+  AdmittedWorkflowNodeIdentity,
+  AgentExecutionSnapshot,
+  AgentCompletionEnvelope,
+  AgentOperationRef,
+  AgentOperationSnapshot,
+  EvidencePort,
+  AgentResumeMechanics,
+  AnalyticalOutcome,
+  AttemptRef,
+  AuthoredDeliverySummary,
+  AuthoredSummaryWithResultHandle,
+  CanonicalProjection,
+  CapabilityBinding,
+  COMMON_CHILD_OPERATION_INSTRUCTIONS,
+  ChildEvidenceProjection,
+  CitationEvidenceRef,
+  ContentEvidenceRef,
+  ContentHandle,
+  ContentReadContextView,
+  ContentReadGrant,
+  ContextMaterialization,
+  ContextSourceRef,
+  ContextView,
+  ContextViewPolicy,
+  ContinuationState,
+  ContractRef,
+  CatalogToolEntry,
+  DELIVERY_PREVIEW_MAX_BYTES,
+  DELIVERY_PREVIEW_POLICY_VERSION,
+  DeliveryAdditionalOutput,
+  DeliveryEnvelope,
+  DeliveryEnvelopeV1,
+  DeliveryEnvelopeV2,
+  DeliveryFailure,
+  DeliveryPreview,
+  DeliveryPrimary,
+  DeliveryPrimaryV2,
+  DeliverySettlement,
+  DeliveryWarning,
+  DependencyAcceptancePolicy,
+  DurableArtifactSelector,
+  EvidenceObservation,
+  EvidenceRef,
+  ExecuteTaskDisposition,
+  ExecutionIdentity,
+  ExecutionSettlement,
+  GrantContentPageAuthorization,
+  InlineExactContextView,
+  InvocationArgumentSelector,
+  LiteralSelector,
+  LiveToolCapabilityBinding,
+  LogicalTaskRef,
+  NamedArtifact,
+  NodeValueSelector,
+  NonExecutionReason,
+  ObservedSourceEvidenceRef,
+  OperationUnavailable,
+  OrdinaryDelegationTaskRef,
+  OutcomePolicy,
+  OutcomeRequirement,
+  OutcomeRoute,
+  OwnerBinding,
+  ParentResultMaterialization,
+  ParentResultPolicy,
+  PhaseOutputSelector,
+  PipelineStageTaskRef,
+  PlatformToolCatalog,
+  ProviderToolDefinition,
+  ProjectionInline,
+  ProjectionRequirement,
+  PUBLISHED_OUTPUT_INLINE_MAX_BYTES,
+  PublishedInlineView,
+  PublishedOutput,
+  PublishedOutputPageAuthorization,
+  PublishedOutputRef,
+  RequestedDataRef,
+  RequestedDataSelector,
+  ResolvedAuthority,
+  ResultHandle,
+  ResultRequirement,
+  SELECTED_CONTENT_UTF8_CONTRACT,
+  SelectedContentSelector,
+  SemanticCapabilityRequirement,
+  SemanticExcerptContextView,
+  SettleWithoutExecutionDisposition,
+  SettlementProjection,
+  TaskObservation,
+  TaskResult,
+  TaskResultProvenance,
+  TaskResultRef,
+  TaskResultValues,
+  TaskExecutionDisposition,
+  TaskSettlementAcceptancePolicy,
+  TERMINAL_NARRATIVE_CONTRACT,
+  TerminalNarrativeInlineExact,
+  TerminalPhaseRevision,
+  ToolGrant,
+  ToolGrantEntry,
+  TranscriptHandle,
+  TypedInputCapabilityBinding,
+  UnsatisfiedCapability,
+  UsageObservation,
+  ValidationVerdictAcceptancePolicy,
+  WORKFLOW_CONTENT_MAX_SEQUENCE,
+  WORKFLOW_CONTENT_PAGE_MAX_BYTES,
+  WorkflowContentCursor,
+  WorkflowContentError,
+  WorkflowContentIntegrityError,
+  WorkflowContentNotFoundError,
+  WorkflowContentPage,
+  WorkflowContentPageAuthorization,
+  WorkflowContentView,
+  WorkflowAnomalyView,
+  WorkflowAuthorFailureView,
+  WorkflowContinuationAcceptedView,
+  WorkflowDeliverySpec,
+  WorkflowDeliverySpecV1,
+  WorkflowDeliverySpecV2,
+  WorkflowNodeTaskRef,
+  WorkflowOutputReadRecipe,
+  WorkflowRecoveryHint,
+  WorkflowResult,
+  WorkflowView,
+  WorkflowViewNodeState,
+  WorkflowViewPhase,
+  WorkspaceGrant,
+  canonical_json_bytes,
+  compose_operation_instructions,
+  parse_delivery_envelope,
+  parse_workflow_delivery_spec,
+  sha256_digest,
+  terminal_task_result,
+  verified_text,
+)
+from .schema import (
+  SCHEMA_BUNDLE_VERSION,
+  export_public_json_schemas,
+  public_json_schemas,
+  public_schema_bundle,
+  public_schema_bundle_json,
+)
+
+__all__ = [
+  "ActivityHandle",
+  "AdmittedDataRef",
+  "AdmittedInputBinding",
+  "AdmittedPlanRef",
+  "AdmittedTask",
+  "AdmittedToolRoute",
+  "AdmittedWorkflowNodeIdentity",
+  "AgentExecutionSnapshot",
+  "AgentCompletionEnvelope",
+  "AgentOperationRef",
+  "AgentOperationSnapshot",
+  "EvidencePort",
+  "AgentResumeMechanics",
+  "AnalyticalOutcome",
+  "AttemptRef",
+  "AuthoredDeliverySummary",
+  "AuthoredSummaryWithResultHandle",
+  "CanonicalProjection",
+  "CapabilityBinding",
+  "COMMON_CHILD_OPERATION_INSTRUCTIONS",
+  "CatalogToolEntry",
+  "ChildEvidenceProjection",
+  "CitationEvidenceRef",
+  "ContentEvidenceRef",
+  "ContentHandle",
+  "ContentReadContextView",
+  "ContentReadGrant",
+  "ContextMaterialization",
+  "ContextSourceRef",
+  "ContextView",
+  "ContextViewPolicy",
+  "ContinuationState",
+  "ContractRef",
+  "DELIVERY_PREVIEW_MAX_BYTES",
+  "DELIVERY_PREVIEW_POLICY_VERSION",
+  "DeliveryAdditionalOutput",
+  "DeliveryEnvelope",
+  "DeliveryEnvelopeV1",
+  "DeliveryEnvelopeV2",
+  "DeliveryFailure",
+  "DeliveryPreview",
+  "DeliveryPrimary",
+  "DeliveryPrimaryV2",
+  "DeliverySettlement",
+  "DeliveryWarning",
+  "DependencyAcceptancePolicy",
+  "DurableArtifactSelector",
+  "EvidenceObservation",
+  "EvidenceRef",
+  "ExecuteTaskDisposition",
+  "ExecutionIdentity",
+  "ExecutionSettlement",
+  "GrantContentPageAuthorization",
+  "InlineExactContextView",
+  "InvocationArgumentSelector",
+  "LiteralSelector",
+  "LiveToolCapabilityBinding",
+  "LogicalTaskRef",
+  "NamedArtifact",
+  "NodeValueSelector",
+  "NonExecutionReason",
+  "ObservedSourceEvidenceRef",
+  "OperationUnavailable",
+  "OrdinaryDelegationTaskRef",
+  "OutcomePolicy",
+  "OutcomeRequirement",
+  "OutcomeRoute",
+  "OwnerBinding",
+  "ParentResultMaterialization",
+  "ParentResultPolicy",
+  "PhaseOutputSelector",
+  "PipelineStageTaskRef",
+  "PlatformToolCatalog",
+  "ProviderToolDefinition",
+  "ProjectionInline",
+  "ProjectionRequirement",
+  "PUBLISHED_OUTPUT_INLINE_MAX_BYTES",
+  "PublishedInlineView",
+  "PublishedOutput",
+  "PublishedOutputPageAuthorization",
+  "PublishedOutputRef",
+  "RequestedDataRef",
+  "RequestedDataSelector",
+  "ResolvedAuthority",
+  "ResultHandle",
+  "ResultRequirement",
+  "SCHEMA_BUNDLE_VERSION",
+  "SELECTED_CONTENT_UTF8_CONTRACT",
+  "SelectedContentSelector",
+  "SemanticCapabilityRequirement",
+  "SemanticExcerptContextView",
+  "SettleWithoutExecutionDisposition",
+  "SettlementProjection",
+  "TaskObservation",
+  "TaskResult",
+  "TaskResultProvenance",
+  "TaskResultRef",
+  "TaskResultValues",
+  "TaskExecutionDisposition",
+  "TaskSettlementAcceptancePolicy",
+  "TERMINAL_NARRATIVE_CONTRACT",
+  "TerminalNarrativeInlineExact",
+  "TerminalPhaseRevision",
+  "ToolGrant",
+  "ToolGrantEntry",
+  "TranscriptHandle",
+  "TypedInputCapabilityBinding",
+  "UnsatisfiedCapability",
+  "UsageObservation",
+  "ValidationVerdictAcceptancePolicy",
+  "WORKFLOW_CONTENT_MAX_SEQUENCE",
+  "WORKFLOW_CONTENT_PAGE_MAX_BYTES",
+  "WorkflowContentCursor",
+  "WorkflowContentError",
+  "WorkflowContentIntegrityError",
+  "WorkflowContentNotFoundError",
+  "WorkflowContentPage",
+  "WorkflowContentPageAuthorization",
+  "WorkflowContentView",
+  "WorkflowAnomalyView",
+  "WorkflowAuthorFailureView",
+  "WorkflowContinuationAcceptedView",
+  "WorkflowDeliverySpec",
+  "WorkflowDeliverySpecV1",
+  "WorkflowDeliverySpecV2",
+  "WorkflowNodeTaskRef",
+  "WorkflowOutputReadRecipe",
+  "WorkflowRecoveryHint",
+  "WorkflowResult",
+  "WorkflowView",
+  "WorkflowViewNodeState",
+  "WorkflowViewPhase",
+  "WorkspaceGrant",
+  "canonical_json_bytes",
+  "compose_operation_instructions",
+  "export_public_json_schemas",
+  "parse_delivery_envelope",
+  "parse_workflow_delivery_spec",
+  "public_json_schemas",
+  "public_schema_bundle",
+  "public_schema_bundle_json",
+  "sha256_digest",
+  "terminal_task_result",
+  "verified_text",
+]

agent_workflow_contracts-1.0.0/agent_workflow_contracts/context_refs.py

@@ -0,0 +1,93 @@
+"""Exact workflow refs shared by pipeline stages and named child admission.
+
+The producer's readback mints artifact refs. Consumers do not paste that bag:
+a granted content handle is the transport, and one owner renders the lines.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+
+def read_back_refs(primary_fms_result: Mapping[str, Any]) -> dict[str, Any]:
+  """Name a door's exact refs, including the three-field skill-artifact ref.
+
+  The consumer's own door validates the ref. Skill artifact sidecar fields are
+  not part of its identity and must not travel in the minted ref. A door that
+  published a ModelVersion names it as ``model_version_ref``, so a later
+  publication replaces an earlier one and a consumer prices the version the
+  workflow published last; the build report also names the SourceBundle it
+  compiled as ``source_bundle_id``.
+
+  A skill-artifact read (``get_skill_artifact``) returns the sidecar the caller
+  selected at ``artifact``; it names only that artifact's three-field ref. Its
+  ``*_ref`` keys and published ModelVersion are what the artifact recorded when
+  it was written, not what the workflow holds now, so they are not minted.
+  """
+  artifact = primary_fms_result.get("artifact")
+  refs: dict[str, Any] = _skill_artifact_ref(artifact) if isinstance(artifact, Mapping) else {}
+  readback = primary_fms_result.get("readback")
+  if not isinstance(readback, Mapping):
+    return refs
+  refs.update(
+    (str(key), value)
+    for key, value in readback.items()
+    if str(key).endswith("_ref") and value is not None
+  )
+  refs.update(_skill_artifact_ref(readback))
+  refs.update(_published_model_version_refs(readback))
+  return refs
+
+
+def _skill_artifact_ref(sidecar: Mapping[str, Any]) -> dict[str, Any]:
+  """``<skill>_ref`` as exactly ``{skill, artifact_id, content_sha256}``."""
+  skill = sidecar.get("skill")
+  artifact_id = sidecar.get("artifact_id")
+  content_sha256 = sidecar.get("content_sha256")
+  if not (
+    isinstance(skill, str)
+    and skill
+    and isinstance(artifact_id, str)
+    and artifact_id
+    and isinstance(content_sha256, str)
+    and content_sha256
+  ):
+    return {}
+  return {
+    f"{skill.replace('-', '_')}_ref": {
+      "skill": skill,
+      "artifact_id": artifact_id,
+      "content_sha256": content_sha256,
+    },
+  }
+
+
+def _published_model_version_refs(readback: Mapping[str, Any]) -> dict[str, Any]:
+  """The exact ModelVersion a door published, and the build's SourceBundle.
+
+  Two producers publish a ModelVersion: the build-model report door, whose
+  ``run-bound/1`` typed payload names the build's version and SourceBundle (its
+  failed arm names neither), and a model-writer door, whose sidecar provenance
+  names the successor it published with ``write_target: model_version``.
+  """
+  refs: dict[str, Any] = {}
+  typed_outputs = readback.get("typed_outputs")
+  if isinstance(typed_outputs, Mapping) and typed_outputs.get("schema_version") == "run-bound/1":
+    model_version = typed_outputs.get("model_version")
+    if isinstance(model_version, Mapping):
+      refs["model_version_ref"] = {
+        "model_id": model_version.get("model_id"),
+        "version": model_version.get("version"),
+      }
+    source = typed_outputs.get("source")
+    if isinstance(source, Mapping) and source.get("bundle_id") is not None:
+      refs["source_bundle_id"] = source.get("bundle_id")
+  provenance = readback.get("provenance")
+  if isinstance(provenance, Mapping) and provenance.get("write_target") == "model_version":
+    refs["model_version_ref"] = {
+      "model_id": provenance.get("model_id"),
+      "version": provenance.get("model_version"),
+    }
+  return refs
+

agent_workflow_contracts-1.0.0/agent_workflow_contracts/generated/admitted-data-ref.schema.json

@@ -0,0 +1 @@
+{"$defs":{"ContentHandle":{"additionalProperties":false,"properties":{"content_bytes":{"minimum":0,"title":"Content Bytes","type":"integer"},"content_chars":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Content Chars"},"content_id":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Content Id","type":"string"},"content_sha256":{"pattern":"^[0-9a-f]{64}$","title":"Content Sha256","type":"string"},"contract":{"$ref":"#/$defs/ContractRef"},"encoding":{"anyOf":[{"maxLength":32,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Encoding"},"media_type":{"maxLength":255,"minLength":1,"title":"Media Type","type":"string"},"retention":{"enum":["durable","workflow","session","transient"],"title":"Retention","type":"string"}},"required":["content_id","content_sha256","content_bytes","contract","media_type","retention"],"title":"ContentHandle","type":"object"},"ContentReadGrant":{"additionalProperties":false,"properties":{"content_id":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Content Id","type":"string"},"grant_id":{"maxLength":512,"minLength":1,"title":"Grant Id","type":"string"},"kind":{"const":"content_read_grant","default":"content_read_grant","title":"Kind","type":"string"},"principal_id":{"maxLength":512,"minLength":1,"title":"Principal Id","type":"string"},"scope":{"enum":["this_task","direct_parent"],"title":"Scope","type":"string"}},"required":["grant_id","content_id","scope","principal_id"],"title":"ContentReadGrant","type":"object"},"ContextViewPolicy":{"additionalProperties":false,"properties":{"max_bytes":{"minimum":1,"title":"Max Bytes","type":"integer"},"on_overflow":{"enum":["content_read","semantic_excerpt","fail"],"title":"On Overflow","type":"string"},"preferred":{"enum":["inline_exact","semantic_excerpt","content_read"],"title":"Preferred","type":"string"}},"required":["preferred","max_bytes","on_overflow"],"title":"ContextViewPolicy","type":"object"},"ContractRef":{"additionalProperties":false,"properties":{"digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Digest","type":"string"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"namespace":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Namespace","type":"string"},"version":{"pattern":"^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$","title":"Version","type":"string"}},"required":["namespace","name","version","digest"],"title":"ContractRef","type":"object"},"DurableArtifactSelector":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":512,"minLength":1,"title":"Artifact Id","type":"string"},"kind":{"const":"durable_artifact_selector","default":"durable_artifact_selector","title":"Kind","type":"string"}},"required":["artifact_id"],"title":"DurableArtifactSelector","type":"object"},"InvocationArgumentSelector":{"additionalProperties":false,"properties":{"argument_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Argument Name","type":"string"},"kind":{"const":"invocation_argument_selector","default":"invocation_argument_selector","title":"Kind","type":"string"}},"required":["argument_name"],"title":"InvocationArgumentSelector","type":"object"},"JsonValue":{},"LiteralSelector":{"additionalProperties":false,"properties":{"kind":{"const":"literal_selector","default":"literal_selector","title":"Kind","type":"string"},"value":{"$ref":"#/$defs/JsonValue"}},"required":["value"],"title":"LiteralSelector","type":"object"},"NodeValueSelector":{"additionalProperties":false,"properties":{"artifact_name":{"anyOf":[{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},{"type":"null"}],"default":null,"title":"Artifact Name"},"kind":{"const":"node_value_selector","default":"node_value_selector","title":"Kind","type":"string"},"node_id":{"maxLength":512,"minLength":1,"title":"Node Id","type":"string"},"projection_path":{"default":[],"items":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},"title":"Projection Path","type":"array"},"value_kind":{"enum":["narrative","projection","artifact"],"title":"Value Kind","type":"string"}},"required":["node_id","value_kind"],"title":"NodeValueSelector","type":"object"},"OwnerBinding":{"additionalProperties":false,"properties":{"invocation_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Invocation Id"},"session_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Session Id"},"tenant_id":{"maxLength":512,"minLength":1,"title":"Tenant Id","type":"string"},"workflow_run_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Workflow Run Id"}},"required":["tenant_id"],"title":"OwnerBinding","type":"object"},"PhaseOutputSelector":{"additionalProperties":false,"properties":{"kind":{"const":"phase_output_selector","default":"phase_output_selector","title":"Kind","type":"string"},"output_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Output Name","type":"string"},"phase_number":{"minimum":1,"title":"Phase Number","type":"integer"},"revision":{"minimum":1,"title":"Revision","type":"integer"}},"required":["phase_number","revision","output_name"],"title":"PhaseOutputSelector","type":"object"},"RequestedDataRef":{"additionalProperties":false,"properties":{"context_policy":{"anyOf":[{"$ref":"#/$defs/ContextViewPolicy"},{"type":"null"}],"default":null},"expected_contract":{"$ref":"#/$defs/ContractRef"},"kind":{"const":"requested_data","default":"requested_data","title":"Kind","type":"string"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"selector":{"discriminator":{"mapping":{"durable_artifact_selector":"#/$defs/DurableArtifactSelector","invocation_argument_selector":"#/$defs/InvocationArgumentSelector","literal_selector":"#/$defs/LiteralSelector","node_value_selector":"#/$defs/NodeValueSelector","phase_output_selector":"#/$defs/PhaseOutputSelector","selected_content_selector":"#/$defs/SelectedContentSelector"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/InvocationArgumentSelector"},{"$ref":"#/$defs/LiteralSelector"},{"$ref":"#/$defs/SelectedContentSelector"},{"$ref":"#/$defs/NodeValueSelector"},{"$ref":"#/$defs/PhaseOutputSelector"},{"$ref":"#/$defs/DurableArtifactSelector"}],"title":"Selector"}},"required":["name","selector","expected_contract"],"title":"RequestedDataRef","type":"object"},"SelectedContentSelector":{"additionalProperties":false,"properties":{"input_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Input Name","type":"string"},"kind":{"const":"selected_content_selector","default":"selected_content_selector","title":"Kind","type":"string"}},"required":["input_name"],"title":"SelectedContentSelector","type":"object"}},"additionalProperties":false,"properties":{"actual_contract":{"$ref":"#/$defs/ContractRef"},"content":{"$ref":"#/$defs/ContentHandle"},"kind":{"const":"admitted_data","default":"admitted_data","title":"Kind","type":"string"},"logical_source_id":{"maxLength":512,"minLength":1,"title":"Logical Source Id","type":"string"},"owner":{"$ref":"#/$defs/OwnerBinding"},"read_grant":{"anyOf":[{"$ref":"#/$defs/ContentReadGrant"},{"type":"null"}],"default":null},"request":{"$ref":"#/$defs/RequestedDataRef"},"source_kind":{"enum":["invocation_argument","literal","selected_content","node_value","phase_output","durable_artifact"],"title":"Source Kind","type":"string"}},"required":["request","source_kind","logical_source_id","owner","actual_contract","content"],"title":"AdmittedDataRef","type":"object"}

agent_workflow_contracts-1.0.0/agent_workflow_contracts/generated/admitted-task.schema.json

@@ -0,0 +1 @@
+{"$defs":{"AdmittedContextWire":{"additionalProperties":false,"description":"Everything `admit` derives for one spawned job (execution-boundary design §3.2).","properties":{"approval_route":{"enum":["durable_local","parent_delegated","no_approval_route"],"title":"Approval Route","type":"string"},"budget_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Share"},"capability_bind":{"$ref":"#/$defs/CapabilityBind"},"children":{"items":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},"title":"Children","type":"array"},"env_projection":{"items":{"maxLength":512,"minLength":1,"type":"string"},"title":"Env Projection","type":"array"},"handle_grants":{"items":{"maxLength":512,"minLength":1,"type":"string"},"title":"Handle Grants","type":"array"},"lineage":{"$ref":"#/$defs/AdmittedLineage"},"placement":{"enum":["in_process","local_stub","hosted_stub"],"title":"Placement","type":"string"},"research_binding":{"$ref":"#/$defs/AdmittedResearchBinding"},"selection_provenance":{"anyOf":[{"$ref":"#/$defs/SelectionProvenance"},{"type":"null"}],"default":null},"selection_snapshot":{"anyOf":[{"additionalProperties":{"$ref":"#/$defs/JsonValue"},"type":"object"},{"type":"null"}],"default":null,"title":"Selection Snapshot"},"tenant":{"anyOf":[{"$ref":"#/$defs/AdmittedTenant"},{"type":"null"}]},"tool_grant":{"items":{"maxLength":512,"minLength":1,"type":"string"},"title":"Tool Grant","type":"array"},"withheld_tools":{"default":[],"items":{"type":"string"},"title":"Withheld Tools","type":"array"}},"required":["tenant","research_binding","capability_bind","children","tool_grant","budget_share","env_projection","approval_route","handle_grants","placement","lineage"],"title":"AdmittedContextWire","type":"object"},"AdmittedDataRef":{"additionalProperties":false,"properties":{"actual_contract":{"$ref":"#/$defs/ContractRef"},"content":{"$ref":"#/$defs/ContentHandle"},"kind":{"const":"admitted_data","default":"admitted_data","title":"Kind","type":"string"},"logical_source_id":{"maxLength":512,"minLength":1,"title":"Logical Source Id","type":"string"},"owner":{"$ref":"#/$defs/OwnerBinding"},"read_grant":{"anyOf":[{"$ref":"#/$defs/ContentReadGrant"},{"type":"null"}],"default":null},"request":{"$ref":"#/$defs/RequestedDataRef"},"source_kind":{"enum":["invocation_argument","literal","selected_content","node_value","phase_output","durable_artifact"],"title":"Source Kind","type":"string"}},"required":["request","source_kind","logical_source_id","owner","actual_contract","content"],"title":"AdmittedDataRef","type":"object"},"AdmittedInputBinding":{"additionalProperties":false,"properties":{"context":{"discriminator":{"mapping":{"content_read":"#/$defs/ContentReadContextView","inline_exact":"#/$defs/InlineExactContextView","semantic_excerpt":"#/$defs/SemanticExcerptContextView"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/InlineExactContextView"},{"$ref":"#/$defs/SemanticExcerptContextView"},{"$ref":"#/$defs/ContentReadContextView"}],"title":"Context"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"source":{"$ref":"#/$defs/AdmittedDataRef"}},"required":["name","source","context"],"title":"AdmittedInputBinding","type":"object"},"AdmittedLineage":{"additionalProperties":false,"properties":{"depth":{"minimum":0,"title":"Depth","type":"integer"},"parent_job_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"title":"Parent Job Id"}},"required":["parent_job_id","depth"],"title":"AdmittedLineage","type":"object"},"AdmittedResearchBinding":{"additionalProperties":false,"description":"The research file and ticker a job is bound to, or none.","properties":{"research_file_id":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Research File Id"},"ticker":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Ticker"}},"title":"AdmittedResearchBinding","type":"object"},"AdmittedTenant":{"additionalProperties":false,"description":"The tenant a job acts for; a child always holds its parent's.","properties":{"role":{"enum":["owner","invite"],"title":"Role","type":"string"},"storage_id":{"title":"Storage Id","type":"string"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Tenant Id"}},"required":["storage_id","role"],"title":"AdmittedTenant","type":"object"},"AdmittedToolRoute":{"additionalProperties":false,"description":"The exact physical route retained with one admitted tool grant.","properties":{"origin":{"enum":["local","mcp"],"title":"Origin","type":"string"},"server_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"title":"Server Id"},"tool_id":{"maxLength":512,"minLength":1,"title":"Tool Id","type":"string"}},"required":["tool_id","origin","server_id"],"title":"AdmittedToolRoute","type":"object"},"AdmittedWorkflowNodeIdentity":{"additionalProperties":false,"properties":{"item_key":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Item Key"},"node_id":{"maxLength":512,"minLength":1,"title":"Node Id","type":"string"},"phase_number":{"minimum":1,"title":"Phase Number","type":"integer"},"plan_id":{"maxLength":512,"minLength":1,"title":"Plan Id","type":"string"},"revision":{"minimum":1,"title":"Revision","type":"integer"},"workflow_run_id":{"maxLength":512,"minLength":1,"title":"Workflow Run Id","type":"string"}},"required":["workflow_run_id","plan_id","phase_number","revision","node_id"],"title":"AdmittedWorkflowNodeIdentity","type":"object"},"AgentExecutionSnapshot":{"additionalProperties":false,"description":"Exact prompt and mechanics consumed by one admitted child attempt.","properties":{"admission_date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Admission Date","type":"string"},"admitted_context":{"anyOf":[{"$ref":"#/$defs/AdmittedContextWire"},{"type":"null"}],"default":null},"client_timeout_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Recorded history from runs admitted before TC9; no runtime code reads this value.","title":"Client Timeout Seconds"},"cost_observation_threshold_usd":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Telemetry-only runaway-cost observation threshold. This value never authorizes, admits, interrupts, gates, or settles execution.","title":"Cost Observation Threshold Usd"},"max_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Max Budget Usd"},"max_tokens":{"minimum":1,"title":"Max Tokens","type":"integer"},"max_turns":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Max Turns"},"persisted_methodology_state":{"anyOf":[{"$ref":"#/$defs/JsonValue"},{"type":"null"}]},"provider_tool_definitions":{"anyOf":[{"items":{"$ref":"#/$defs/ProviderToolDefinition"},"type":"array"},{"type":"null"}],"default":null,"title":"Provider Tool Definitions"},"result_instructions":{"minLength":1,"title":"Result Instructions","type":"string"},"resume_instruction":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Resume Instruction"},"resume_mechanics":{"$ref":"#/$defs/AgentResumeMechanics"},"system_prompt":{"minLength":1,"title":"System Prompt","type":"string"},"temperature":{"anyOf":[{"maximum":2.0,"minimum":0.0,"type":"number"},{"type":"null"}],"default":null,"title":"Temperature"},"timeout_seconds":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Timeout Seconds"},"top_p":{"anyOf":[{"maximum":1.0,"minimum":0.0,"type":"number"},{"type":"null"}],"default":null,"title":"Top P"}},"required":["system_prompt","admission_date","persisted_methodology_state","result_instructions","max_tokens","resume_mechanics"],"title":"AgentExecutionSnapshot","type":"object"},"AgentOperationRef":{"additionalProperties":false,"description":"Full immutable identity of an executable operation.","properties":{"digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Digest","type":"string"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"namespace":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Namespace","type":"string"},"version":{"pattern":"^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$","title":"Version","type":"string"}},"required":["namespace","name","version","digest"],"title":"AgentOperationRef","type":"object"},"AgentOperationSnapshot":{"additionalProperties":false,"properties":{"children":{"default":[],"items":{"type":"string"},"title":"Children","type":"array"},"description":{"maxLength":2048,"minLength":1,"title":"Description","type":"string"},"effort":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Effort"},"evidence_ports":{"default":[],"items":{"$ref":"#/$defs/EvidencePort"},"maxItems":4,"title":"Evidence Ports","type":"array"},"execution_class":{"maxLength":512,"minLength":1,"title":"Execution Class","type":"string"},"instructions":{"minLength":1,"title":"Instructions","type":"string"},"methodology":{"$ref":"#/$defs/ContractRef"},"operation":{"$ref":"#/$defs/AgentOperationRef"},"projection_contracts":{"default":[],"items":{"$ref":"#/$defs/ContractRef"},"title":"Projection Contracts","type":"array"},"prompt":{"$ref":"#/$defs/ContractRef"},"required_capabilities":{"default":[],"items":{"$ref":"#/$defs/SemanticCapabilityRequirement"},"title":"Required Capabilities","type":"array"},"required_context":{"default":[],"items":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},"maxItems":8,"title":"Required Context","type":"array"},"result_modes":{"items":{"type":"string"},"minItems":1,"title":"Result Modes","type":"array"},"result_requires_persist":{"default":false,"title":"Result Requires Persist","type":"boolean"},"resumable":{"default":false,"title":"Resumable","type":"boolean"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Role"},"terminal_on_persist":{"default":true,"title":"Terminal On Persist","type":"boolean"},"workspace_scope":{"enum":["read_only","workspace_write","model_write"],"title":"Workspace Scope","type":"string"}},"required":["operation","methodology","prompt","description","instructions","execution_class","workspace_scope","result_modes"],"title":"AgentOperationSnapshot","type":"object"},"AgentResumeMechanics":{"additionalProperties":false,"description":"Exact admitted continuation mechanics for one logical child task.","properties":{"control_message_strategy":{"const":"admitted_exact","title":"Control Message Strategy","type":"string"},"max_chain_depth":{"minimum":0,"title":"Max Chain Depth","type":"integer"},"prompt_strategy":{"const":"reuse_exact","title":"Prompt Strategy","type":"string"},"resumable":{"title":"Resumable","type":"boolean"},"tool_grant_strategy":{"const":"reissue_exact","title":"Tool Grant Strategy","type":"string"},"transcript_strategy":{"const":"durable_reconstruction","title":"Transcript Strategy","type":"string"}},"required":["resumable","max_chain_depth","transcript_strategy","prompt_strategy","tool_grant_strategy","control_message_strategy"],"title":"AgentResumeMechanics","type":"object"},"AttemptRef":{"additionalProperties":false,"properties":{"attempt_id":{"maxLength":512,"minLength":1,"title":"Attempt Id","type":"string"},"attempt_number":{"minimum":1,"title":"Attempt Number","type":"integer"},"physical_task_id":{"maxLength":512,"minLength":1,"title":"Physical Task Id","type":"string"},"restart_of_attempt_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Restart Of Attempt Id"},"resume_of_task_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Resume Of Task Id"},"resumer_job_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Resumer Job Id"}},"required":["attempt_number","attempt_id","physical_task_id"],"title":"AttemptRef","type":"object"},"CapabilityBind":{"additionalProperties":false,"description":"Complete, secret-free execution identity for one admitted capability.","properties":{"adapter":{"maxLength":512,"minLength":1,"title":"Adapter","type":"string"},"capability_id":{"maxLength":512,"minLength":1,"title":"Capability Id","type":"string"},"credential_principal":{"enum":["user","service"],"title":"Credential Principal","type":"string"},"credential_ref":{"maxLength":512,"minLength":1,"title":"Credential Ref","type":"string"},"effort":{"enum":["none","minimal","low","medium","high","xhigh","max"],"title":"Effort","type":"string"},"model_key":{"maxLength":512,"minLength":1,"title":"Model Key","type":"string"},"policy_revision":{"pattern":"^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$","title":"Policy Revision","type":"string"},"protocol_profile":{"maxLength":512,"minLength":1,"title":"Protocol Profile","type":"string"},"provider":{"maxLength":512,"minLength":1,"title":"Provider","type":"string"},"registry_revision":{"pattern":"^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$","title":"Registry Revision","type":"string"},"route":{"maxLength":512,"minLength":1,"title":"Route","type":"string"},"run_mode":{"enum":["interactive","fleet","batch","autonomous","cron"],"title":"Run Mode","type":"string"},"schema_version":{"const":"1.0","title":"Schema Version","type":"string"},"selection_source":{"enum":["explicit_user","saved_preference","channel_default","capability_default","internal_policy","parent_binding"],"title":"Selection Source","type":"string"},"upstream_model":{"maxLength":512,"minLength":1,"title":"Upstream Model","type":"string"}},"required":["schema_version","capability_id","model_key","provider","upstream_model","adapter","protocol_profile","route","effort","credential_principal","credential_ref","run_mode","registry_revision","policy_revision","selection_source"],"title":"CapabilityBind","type":"object"},"ContentHandle":{"additionalProperties":false,"properties":{"content_bytes":{"minimum":0,"title":"Content Bytes","type":"integer"},"content_chars":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Content Chars"},"content_id":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Content Id","type":"string"},"content_sha256":{"pattern":"^[0-9a-f]{64}$","title":"Content Sha256","type":"string"},"contract":{"$ref":"#/$defs/ContractRef"},"encoding":{"anyOf":[{"maxLength":32,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Encoding"},"media_type":{"maxLength":255,"minLength":1,"title":"Media Type","type":"string"},"retention":{"enum":["durable","workflow","session","transient"],"title":"Retention","type":"string"}},"required":["content_id","content_sha256","content_bytes","contract","media_type","retention"],"title":"ContentHandle","type":"object"},"ContentReadContextView":{"additionalProperties":false,"properties":{"complete":{"const":false,"default":false,"title":"Complete","type":"boolean"},"kind":{"const":"content_read","default":"content_read","title":"Kind","type":"string"},"read_grant":{"$ref":"#/$defs/ContentReadGrant"},"source":{"$ref":"#/$defs/ContextSourceRef"}},"required":["source","read_grant"],"title":"ContentReadContextView","type":"object"},"ContentReadGrant":{"additionalProperties":false,"properties":{"content_id":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Content Id","type":"string"},"grant_id":{"maxLength":512,"minLength":1,"title":"Grant Id","type":"string"},"kind":{"const":"content_read_grant","default":"content_read_grant","title":"Kind","type":"string"},"principal_id":{"maxLength":512,"minLength":1,"title":"Principal Id","type":"string"},"scope":{"enum":["this_task","direct_parent"],"title":"Scope","type":"string"}},"required":["grant_id","content_id","scope","principal_id"],"title":"ContentReadGrant","type":"object"},"ContextSourceRef":{"additionalProperties":false,"properties":{"content_id":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Content Id","type":"string"},"kind":{"const":"admitted_data_ref","default":"admitted_data_ref","title":"Kind","type":"string"},"logical_source_id":{"maxLength":512,"minLength":1,"title":"Logical Source Id","type":"string"}},"required":["logical_source_id","content_id"],"title":"ContextSourceRef","type":"object"},"ContextViewPolicy":{"additionalProperties":false,"properties":{"max_bytes":{"minimum":1,"title":"Max Bytes","type":"integer"},"on_overflow":{"enum":["content_read","semantic_excerpt","fail"],"title":"On Overflow","type":"string"},"preferred":{"enum":["inline_exact","semantic_excerpt","content_read"],"title":"Preferred","type":"string"}},"required":["preferred","max_bytes","on_overflow"],"title":"ContextViewPolicy","type":"object"},"ContractRef":{"additionalProperties":false,"properties":{"digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Digest","type":"string"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"namespace":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Namespace","type":"string"},"version":{"pattern":"^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$","title":"Version","type":"string"}},"required":["namespace","name","version","digest"],"title":"ContractRef","type":"object"},"DurableArtifactSelector":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":512,"minLength":1,"title":"Artifact Id","type":"string"},"kind":{"const":"durable_artifact_selector","default":"durable_artifact_selector","title":"Kind","type":"string"}},"required":["artifact_id"],"title":"DurableArtifactSelector","type":"object"},"EvidencePort":{"additionalProperties":false,"description":"One declared multi-valued evidence input on an operation contract.\n\nAn operation that cannot gather evidence itself declares where upstream\nresults enter.  The catalog owns the fact that the port exists and its\ncardinality floor; the plan author selects only which upstream results\nfeed it.","properties":{"max_selections":{"default":8,"maximum":8,"minimum":1,"title":"Max Selections","type":"integer"},"min_selections":{"default":1,"maximum":8,"minimum":1,"title":"Min Selections","type":"integer"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"}},"required":["name"],"title":"EvidencePort","type":"object"},"ExecuteTaskDisposition":{"additionalProperties":false,"properties":{"kind":{"const":"execute","default":"execute","title":"Kind","type":"string"}},"title":"ExecuteTaskDisposition","type":"object"},"InlineExactContextView":{"additionalProperties":false,"properties":{"complete":{"const":true,"default":true,"title":"Complete","type":"boolean"},"content":{"$ref":"#/$defs/JsonValue"},"content_bytes":{"minimum":0,"title":"Content Bytes","type":"integer"},"kind":{"const":"inline_exact","default":"inline_exact","title":"Kind","type":"string"},"source":{"$ref":"#/$defs/ContextSourceRef"}},"required":["source","content","content_bytes"],"title":"InlineExactContextView","type":"object"},"InvocationArgumentSelector":{"additionalProperties":false,"properties":{"argument_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Argument Name","type":"string"},"kind":{"const":"invocation_argument_selector","default":"invocation_argument_selector","title":"Kind","type":"string"}},"required":["argument_name"],"title":"InvocationArgumentSelector","type":"object"},"JsonValue":{},"LiteralSelector":{"additionalProperties":false,"properties":{"kind":{"const":"literal_selector","default":"literal_selector","title":"Kind","type":"string"},"value":{"$ref":"#/$defs/JsonValue"}},"required":["value"],"title":"LiteralSelector","type":"object"},"LiveToolCapabilityBinding":{"additionalProperties":false,"properties":{"capability":{"maxLength":512,"minLength":1,"title":"Capability","type":"string"},"kind":{"const":"live_tool","default":"live_tool","title":"Kind","type":"string"},"route_id":{"maxLength":512,"minLength":1,"title":"Route Id","type":"string"},"tool_ids":{"items":{"maxLength":512,"minLength":1,"type":"string"},"minItems":1,"title":"Tool Ids","type":"array"}},"required":["capability","route_id","tool_ids"],"title":"LiveToolCapabilityBinding","type":"object"},"NodeValueSelector":{"additionalProperties":false,"properties":{"artifact_name":{"anyOf":[{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},{"type":"null"}],"default":null,"title":"Artifact Name"},"kind":{"const":"node_value_selector","default":"node_value_selector","title":"Kind","type":"string"},"node_id":{"maxLength":512,"minLength":1,"title":"Node Id","type":"string"},"projection_path":{"default":[],"items":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},"title":"Projection Path","type":"array"},"value_kind":{"enum":["narrative","projection","artifact"],"title":"Value Kind","type":"string"}},"required":["node_id","value_kind"],"title":"NodeValueSelector","type":"object"},"OrdinaryDelegationTaskRef":{"additionalProperties":false,"properties":{"delegation_id":{"maxLength":512,"minLength":1,"title":"Delegation Id","type":"string"},"kind":{"const":"ordinary_delegation","default":"ordinary_delegation","title":"Kind","type":"string"},"operation":{"$ref":"#/$defs/AgentOperationRef"}},"required":["delegation_id","operation"],"title":"OrdinaryDelegationTaskRef","type":"object"},"OutcomePolicy":{"additionalProperties":false,"properties":{"routes":{"items":{"$ref":"#/$defs/OutcomeRoute"},"minItems":1,"title":"Routes","type":"array"}},"required":["routes"],"title":"OutcomePolicy","type":"object"},"OutcomeRequirement":{"additionalProperties":false,"properties":{"required":{"const":false,"default":false,"title":"Required","type":"boolean"},"source":{"const":"none","default":"none","title":"Source","type":"string"}},"title":"OutcomeRequirement","type":"object"},"OutcomeRoute":{"additionalProperties":false,"properties":{"action":{"enum":["settle","continue","skip_dependents","fail"],"title":"Action","type":"string"},"disposition":{"enum":["complete","partial","insufficient_evidence","blocked","not_assessed"],"title":"Disposition","type":"string"}},"required":["disposition","action"],"title":"OutcomeRoute","type":"object"},"OwnerBinding":{"additionalProperties":false,"properties":{"invocation_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Invocation Id"},"session_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Session Id"},"tenant_id":{"maxLength":512,"minLength":1,"title":"Tenant Id","type":"string"},"workflow_run_id":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Workflow Run Id"}},"required":["tenant_id"],"title":"OwnerBinding","type":"object"},"PhaseOutputSelector":{"additionalProperties":false,"properties":{"kind":{"const":"phase_output_selector","default":"phase_output_selector","title":"Kind","type":"string"},"output_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Output Name","type":"string"},"phase_number":{"minimum":1,"title":"Phase Number","type":"integer"},"revision":{"minimum":1,"title":"Revision","type":"integer"}},"required":["phase_number","revision","output_name"],"title":"PhaseOutputSelector","type":"object"},"PipelineStageTaskRef":{"additionalProperties":false,"description":"One pipeline stage attempt, a durable child of the execution that runs it.\n\nRecorded as a default where the logical-task contract was open. Revert site:\nuse OrdinaryDelegationTaskRef with delegation_id set to the stage run id.","properties":{"kind":{"const":"pipeline_stage","default":"pipeline_stage","title":"Kind","type":"string"},"operation":{"$ref":"#/$defs/AgentOperationRef"},"pipeline_id":{"maxLength":512,"minLength":1,"title":"Pipeline Id","type":"string"},"stage_id":{"maxLength":512,"minLength":1,"title":"Stage Id","type":"string"}},"required":["pipeline_id","stage_id","operation"],"title":"PipelineStageTaskRef","type":"object"},"ProjectionRequirement":{"additionalProperties":false,"properties":{"contract":{"$ref":"#/$defs/ContractRef"},"required":{"default":true,"title":"Required","type":"boolean"}},"required":["contract"],"title":"ProjectionRequirement","type":"object"},"ProviderToolDefinition":{"additionalProperties":false,"description":"One exact provider-facing tool definition frozen for child execution.","properties":{"definition":{"additionalProperties":{"$ref":"#/$defs/JsonValue"},"title":"Definition","type":"object"}},"required":["definition"],"title":"ProviderToolDefinition","type":"object"},"RequestedDataRef":{"additionalProperties":false,"properties":{"context_policy":{"anyOf":[{"$ref":"#/$defs/ContextViewPolicy"},{"type":"null"}],"default":null},"expected_contract":{"$ref":"#/$defs/ContractRef"},"kind":{"const":"requested_data","default":"requested_data","title":"Kind","type":"string"},"name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Name","type":"string"},"selector":{"discriminator":{"mapping":{"durable_artifact_selector":"#/$defs/DurableArtifactSelector","invocation_argument_selector":"#/$defs/InvocationArgumentSelector","literal_selector":"#/$defs/LiteralSelector","node_value_selector":"#/$defs/NodeValueSelector","phase_output_selector":"#/$defs/PhaseOutputSelector","selected_content_selector":"#/$defs/SelectedContentSelector"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/InvocationArgumentSelector"},{"$ref":"#/$defs/LiteralSelector"},{"$ref":"#/$defs/SelectedContentSelector"},{"$ref":"#/$defs/NodeValueSelector"},{"$ref":"#/$defs/PhaseOutputSelector"},{"$ref":"#/$defs/DurableArtifactSelector"}],"title":"Selector"}},"required":["name","selector","expected_contract"],"title":"RequestedDataRef","type":"object"},"ResultRequirement":{"additionalProperties":false,"description":"Code-owned result metadata, not a response schema for the model.","properties":{"mode":{"default":"narrative","title":"Mode","type":"string"},"outcome":{"$ref":"#/$defs/OutcomeRequirement"},"projection":{"anyOf":[{"$ref":"#/$defs/ProjectionRequirement"},{"type":"null"}],"default":null},"terminal_narrative":{"default":"required","title":"Terminal Narrative","type":"string"}},"required":["outcome"],"title":"ResultRequirement","type":"object"},"SelectedContentSelector":{"additionalProperties":false,"properties":{"input_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Input Name","type":"string"},"kind":{"const":"selected_content_selector","default":"selected_content_selector","title":"Kind","type":"string"}},"required":["input_name"],"title":"SelectedContentSelector","type":"object"},"SelectionPresetProvenance":{"additionalProperties":false,"description":"The winning preset recorded beside one bind (design §7.4).","properties":{"name":{"title":"Name","type":"string"},"policy_revision":{"title":"Policy Revision","type":"string"},"scope":{"enum":["user","firm","run","subtree"],"title":"Scope","type":"string"}},"required":["name","scope","policy_revision"],"title":"SelectionPresetProvenance","type":"object"},"SelectionProvenance":{"additionalProperties":false,"description":"Role, effort and preset sources beside an exact bind; every key is present.","properties":{"effort_source":{"anyOf":[{"enum":["explicit","spawn","operation"],"type":"string"},{"type":"null"}],"title":"Effort Source"},"preset":{"anyOf":[{"$ref":"#/$defs/SelectionPresetProvenance"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"role_source":{"anyOf":[{"enum":["spawn","operation"],"type":"string"},{"type":"null"}],"title":"Role Source"}},"required":["role","role_source","effort_source","preset"],"title":"SelectionProvenance","type":"object"},"SemanticCapabilityRequirement":{"additionalProperties":false,"properties":{"binding_modes":{"items":{"enum":["typed_input","live_tool"],"type":"string"},"minItems":1,"title":"Binding Modes","type":"array"},"compatible_input_contracts":{"default":[],"items":{"$ref":"#/$defs/ContractRef"},"title":"Compatible Input Contracts","type":"array"},"name":{"maxLength":512,"minLength":1,"title":"Name","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"}},"required":["name","binding_modes"],"title":"SemanticCapabilityRequirement","type":"object"},"SemanticExcerptContextView":{"additionalProperties":false,"properties":{"complete":{"const":false,"default":false,"title":"Complete","type":"boolean"},"content":{"minLength":1,"title":"Content","type":"string"},"content_bytes":{"minimum":1,"title":"Content Bytes","type":"integer"},"kind":{"const":"semantic_excerpt","default":"semantic_excerpt","title":"Kind","type":"string"},"selection_query":{"minLength":1,"title":"Selection Query","type":"string"},"source":{"$ref":"#/$defs/ContextSourceRef"}},"required":["source","content","content_bytes","selection_query"],"title":"SemanticExcerptContextView","type":"object"},"SettleWithoutExecutionDisposition":{"additionalProperties":false,"properties":{"kind":{"const":"settle_without_execution","default":"settle_without_execution","title":"Kind","type":"string"},"reason":{"enum":["dependency_not_accepted","required_input_unavailable","workflow_cancelled","admission_denied"],"title":"Reason","type":"string"},"unavailable_input_names":{"items":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","type":"string"},"title":"Unavailable Input Names","type":"array"}},"required":["reason","unavailable_input_names"],"title":"SettleWithoutExecutionDisposition","type":"object"},"ToolGrant":{"additionalProperties":false,"properties":{"digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Digest","type":"string"},"grant_id":{"maxLength":512,"minLength":1,"title":"Grant Id","type":"string"},"kind":{"const":"tool_grant","default":"tool_grant","title":"Kind","type":"string"},"tools":{"default":[],"items":{"$ref":"#/$defs/ToolGrantEntry"},"title":"Tools","type":"array"}},"required":["grant_id","digest"],"title":"ToolGrant","type":"object"},"ToolGrantEntry":{"additionalProperties":false,"properties":{"effect":{"enum":["read","propose","write","external_effect"],"title":"Effect","type":"string"},"route_id":{"maxLength":512,"minLength":1,"title":"Route Id","type":"string"},"tool_id":{"maxLength":512,"minLength":1,"title":"Tool Id","type":"string"}},"required":["tool_id","route_id","effect"],"title":"ToolGrantEntry","type":"object"},"TypedInputCapabilityBinding":{"additionalProperties":false,"properties":{"capability":{"maxLength":512,"minLength":1,"title":"Capability","type":"string"},"input_contract":{"$ref":"#/$defs/ContractRef"},"input_name":{"pattern":"^[a-z][a-z0-9._-]{0,127}$","title":"Input Name","type":"string"},"kind":{"const":"typed_input","default":"typed_input","title":"Kind","type":"string"}},"required":["capability","input_name","input_contract"],"title":"TypedInputCapabilityBinding","type":"object"},"WorkflowNodeTaskRef":{"additionalProperties":false,"properties":{"item_key":{"anyOf":[{"maxLength":512,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Item Key"},"kind":{"const":"workflow_node","default":"workflow_node","title":"Kind","type":"string"},"node_id":{"maxLength":512,"minLength":1,"title":"Node Id","type":"string"},"operation":{"$ref":"#/$defs/AgentOperationRef"},"phase_number":{"minimum":1,"title":"Phase Number","type":"integer"},"plan_id":{"maxLength":512,"minLength":1,"title":"Plan Id","type":"string"},"revision":{"minimum":1,"title":"Revision","type":"integer"},"workflow_run_id":{"maxLength":512,"minLength":1,"title":"Workflow Run Id","type":"string"}},"required":["workflow_run_id","plan_id","phase_number","revision","node_id","operation"],"title":"WorkflowNodeTaskRef","type":"object"},"WorkspaceGrant":{"additionalProperties":false,"properties":{"kind":{"const":"workspace_grant","default":"workspace_grant","title":"Kind","type":"string"},"scope":{"enum":["read_only","workspace_write","model_write"],"title":"Scope","type":"string"},"workspace_id":{"maxLength":512,"minLength":1,"title":"Workspace Id","type":"string"}},"required":["workspace_id","scope"],"title":"WorkspaceGrant","type":"object"}},"additionalProperties":false,"properties":{"admitted_plan_digest":{"anyOf":[{"pattern":"^sha256:[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Admitted Plan Digest"},"admitted_task_digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Admitted Task Digest","type":"string"},"admitted_task_id":{"maxLength":512,"minLength":1,"title":"Admitted Task Id","type":"string"},"attempt":{"$ref":"#/$defs/AttemptRef"},"capability_binding_digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Capability Binding Digest","type":"string"},"capability_bindings":{"default":[],"items":{"discriminator":{"mapping":{"live_tool":"#/$defs/LiveToolCapabilityBinding","typed_input":"#/$defs/TypedInputCapabilityBinding"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/TypedInputCapabilityBinding"},{"$ref":"#/$defs/LiveToolCapabilityBinding"}]},"title":"Capability Bindings","type":"array"},"content_read_grants":{"default":[],"items":{"$ref":"#/$defs/ContentReadGrant"},"title":"Content Read Grants","type":"array"},"execution_disposition":{"discriminator":{"mapping":{"execute":"#/$defs/ExecuteTaskDisposition","settle_without_execution":"#/$defs/SettleWithoutExecutionDisposition"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/ExecuteTaskDisposition"},{"$ref":"#/$defs/SettleWithoutExecutionDisposition"}],"title":"Execution Disposition"},"execution_snapshot":{"anyOf":[{"$ref":"#/$defs/AgentExecutionSnapshot"},{"type":"null"}]},"inputs":{"default":[],"items":{"$ref":"#/$defs/AdmittedInputBinding"},"title":"Inputs","type":"array"},"logical_task":{"discriminator":{"mapping":{"ordinary_delegation":"#/$defs/OrdinaryDelegationTaskRef","pipeline_stage":"#/$defs/PipelineStageTaskRef","workflow_node":"#/$defs/WorkflowNodeTaskRef"},"propertyName":"kind"},"oneOf":[{"$ref":"#/$defs/OrdinaryDelegationTaskRef"},{"$ref":"#/$defs/WorkflowNodeTaskRef"},{"$ref":"#/$defs/PipelineStageTaskRef"}],"title":"Logical Task"},"model_bind":{"anyOf":[{"$ref":"#/$defs/CapabilityBind"},{"type":"null"}]},"model_bind_digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Model Bind Digest","type":"string"},"objective":{"$ref":"#/$defs/JsonValue"},"operation":{"$ref":"#/$defs/AgentOperationSnapshot"},"outcome_policy":{"$ref":"#/$defs/OutcomePolicy"},"result_requirement":{"$ref":"#/$defs/ResultRequirement"},"schema_version":{"default":"1.1","enum":["1.0","1.1","1.2"],"title":"Schema Version","type":"string"},"tool_grant":{"$ref":"#/$defs/ToolGrant"},"tool_grant_digest":{"pattern":"^sha256:[0-9a-f]{64}$","title":"Tool Grant Digest","type":"string"},"tool_routes":{"anyOf":[{"items":{"$ref":"#/$defs/AdmittedToolRoute"},"type":"array"},{"type":"null"}],"default":null,"title":"Tool Routes"},"workflow_identity":{"anyOf":[{"$ref":"#/$defs/AdmittedWorkflowNodeIdentity"},{"type":"null"}],"default":null},"workspace_grant":{"$ref":"#/$defs/WorkspaceGrant"}},"required":["admitted_task_id","logical_task","attempt","objective","execution_disposition","execution_snapshot","operation","tool_grant","workspace_grant","model_bind","result_requirement","outcome_policy","admitted_task_digest","model_bind_digest","capability_binding_digest","tool_grant_digest"],"title":"AdmittedTask","type":"object"}