python-hwpx 3.0.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

hwpx/agent/__init__.py

@@ -18,6 +18,20 @@ from .model import (
 from .catalog import agent_catalog, agent_json_schemas, catalog_hash, human_help, node_help
 from .commands import apply_document_commands
 from .document import HwpxAgentDocument, NodeRecord
+from .form_plan import (
+    MIXED_FORM_COMPILED_PLAN_SCHEMA,
+    MIXED_FORM_LOCATOR_KINDS,
+    MIXED_FORM_PLAN_SCHEMA,
+    MIXED_FORM_REQUEST_SCHEMA,
+    MixedFormPlan,
+    MixedFormResolution,
+    apply_mixed_form_fill,
+    apply_mixed_form_plan,
+    mixed_form_json_schemas,
+    plan_mixed_form_fill,
+    validate_mixed_form_plan,
+    validate_mixed_form_request,
+)
 from .path import PathSegment, SemanticPath, canonicalize_path, parse_path
 from .query import QueryResult, SemanticSelector, parse_selector
 from .blueprint import (
@@ -52,6 +66,10 @@ __all__ = [
     "AGENT_COMMAND_SCHEMA",
     "AGENT_ERROR_SCHEMA",
     "AGENT_NODE_SCHEMA",
+    "MIXED_FORM_COMPILED_PLAN_SCHEMA",
+    "MIXED_FORM_LOCATOR_KINDS",
+    "MIXED_FORM_PLAN_SCHEMA",
+    "MIXED_FORM_REQUEST_SCHEMA",
     "BLUEPRINT_CATALOG_SCHEMA",
     "BLUEPRINT_REPLAY_RESULT_SCHEMA",
     "BLUEPRINT_REPLAY_SCHEMA",
@@ -65,6 +83,8 @@ __all__ = [
     "BlueprintBundle",
     "BlueprintDumpResult",
     "HwpxAgentDocument",
+    "MixedFormPlan",
+    "MixedFormResolution",
     "NodeRecord",
     "PathSegment",
     "QueryResult",
@@ -74,6 +94,8 @@ __all__ = [
     "agent_json_schemas",
     "agent_contract_manifest",
     "apply_document_commands",
+    "apply_mixed_form_fill",
+    "apply_mixed_form_plan",
     "blueprint_catalog",
     "blueprint_catalog_hash",
     "blueprint_hash",
@@ -84,15 +106,19 @@ __all__ = [
     "canonicalize_path",
     "catalog_hash",
     "human_help",
+    "mixed_form_json_schemas",
     "node_help",
     "parse_path",
     "parse_selector",
+    "plan_mixed_form_fill",
     "dump_document_blueprint",
     "read_blueprint_bundle",
     "repack_blueprint_bundle",
     "replay_document_blueprint",
     "validate_agent_batch",
     "validate_agent_command",
+    "validate_mixed_form_plan",
+    "validate_mixed_form_request",
     "validate_blueprint_manifest",
     "validate_replay_request",
     "write_blueprint_bundle",

hwpx/agent/catalog.py

@@ -9,10 +9,16 @@ from copy import deepcopy
 from typing import Any
 
 from .model import (
+    AGENT_BATCH_SCHEMA,
     AGENT_CATALOG_SCHEMA,
+    MAX_COMMANDS,
     AgentContractError,
     NODE_KINDS,
     NODE_PROPERTY_CATALOG_V1,
+    QUALITY_KEYS,
+    QUALITY_MODES,
+    REVISION_PATTERN,
+    VERIFICATION_REQUIREMENTS,
     agent_contract_manifest,
 )
 
@@ -78,6 +84,22 @@ def agent_json_schemas() -> dict[str, Any]:
                 "properties": {key: value for key, value in properties.items() if key in allowed},
             }
         )
+    quality_object = {
+        "type": "object",
+        "additionalProperties": False,
+        "properties": {
+            "mode": {"enum": list(QUALITY_MODES)},
+            "renderCheck": {"enum": ["off", "auto", "required"]},
+            "xsdMode": {"enum": ["off", "lint"]},
+            "overflowPolicy": {"enum": ["fail", "warn", "truncate"]},
+            "layoutLint": {"enum": ["off", "warn", "strict"]},
+            "preserveUnmodifiedParts": {"type": "boolean"},
+            "requireReferenceIntegrity": {"type": "boolean"},
+        },
+    }
+    if set(quality_object["properties"]) != set(QUALITY_KEYS):  # pragma: no cover
+        raise AssertionError("quality JSON Schema drifted from QUALITY_KEYS")
+
     return {
         "node": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -113,6 +135,69 @@ def agent_json_schemas() -> dict[str, Any]:
             "title": "HwpxAgentCommand v1",
             "oneOf": command_variants,
         },
+        "batch": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "title": "HwpxAgentBatch v1",
+            "type": "object",
+            "required": [
+                "schemaVersion",
+                "input",
+                "output",
+                "commands",
+                "expectedRevision",
+                "idempotencyKey",
+                "dryRun",
+                "quality",
+                "verificationRequirements",
+            ],
+            "additionalProperties": False,
+            "properties": {
+                "schemaVersion": {"const": AGENT_BATCH_SCHEMA},
+                "input": {
+                    "type": "object",
+                    "required": ["filename"],
+                    "additionalProperties": False,
+                    "properties": {"filename": {"type": "string", "minLength": 1}},
+                },
+                "output": {
+                    "type": "object",
+                    "required": ["filename", "overwrite"],
+                    "additionalProperties": False,
+                    "properties": {
+                        "filename": {"type": "string", "minLength": 1},
+                        "overwrite": {"type": "boolean"},
+                    },
+                },
+                "commands": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": MAX_COMMANDS,
+                    "items": {"oneOf": deepcopy(command_variants)},
+                },
+                "expectedRevision": {
+                    "type": ["string", "null"],
+                    "pattern": REVISION_PATTERN.pattern,
+                },
+                "idempotencyKey": {
+                    "type": ["string", "null"],
+                    "minLength": 1,
+                    "maxLength": 128,
+                },
+                "dryRun": {"type": "boolean"},
+                "quality": {
+                    "oneOf": [
+                        {"enum": list(QUALITY_MODES)},
+                        deepcopy(quality_object),
+                        {"type": "null"},
+                    ]
+                },
+                "verificationRequirements": {
+                    "type": "array",
+                    "items": {"enum": list(VERIFICATION_REQUIREMENTS)},
+                    "uniqueItems": True,
+                },
+            },
+        },
         "queryInput": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",