agent-devkit 0.1.6 → 0.2.0

package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/decision-rules.md

@@ -0,0 +1,5 @@
+# Decision Rules
+
+- Nao escrever em disco.
+- Nao gerar codigo para Selenium, PyAutoGUI ou Playwright.
+- Incluir `--dry-run`, `--execute`, `--yes`, redacao de segredo e exit codes.

package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/runner.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+"""Runner for python-automation-builder/generate-python-automation."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+
+REPOSITORY_DIR = Path(__file__).resolve().parents[2] / "infra" / "integrations" / "python-automation"
+sys.path.insert(0, str(REPOSITORY_DIR))
+
+from python_automation_repository import PythonAutomationError, PythonAutomationRepository  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Generate a Python automation script")
+    parser.add_argument("--spec", required=True)
+    args = parser.parse_args()
+
+    try:
+        result = PythonAutomationRepository().generate_python_automation(spec_path=Path(args.spec))
+    except PythonAutomationError as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    print(json.dumps(result, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/workflow.md

@@ -0,0 +1,5 @@
+# Workflow
+
+1. Ler e validar a spec.
+2. Renderizar script Python com argparse, dry-run, confirmacao, logs e resumo.
+3. Retornar o conteudo no stdout sem escrever arquivo.

package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/capability.yaml

@@ -0,0 +1,18 @@
+id: python-automation-builder.plan-python-automation
+kind: capability
+name: Plan Python Automation
+version: 0.1.0
+status: draft
+purpose: Planejar automacao Python sem escrever arquivos.
+entrypoint:
+  runner: runner.py
+  workflow: workflow.md
+  output_template: ../../templates/automation-readme.md
+inputs:
+  required:
+    - spec
+  optional: []
+outputs:
+  artifacts:
+    - python-automation-plan.json
+write_policy: read_only

package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Retornar `needs-input` quando faltar contrato minimo.
+- Bloquear Selenium, PyAutoGUI e Playwright neste agente.
+- Bloquear segredo, token ou URL na spec.
+- Preferir standard library e apontar dependencias externas como risco.

package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/runner.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+"""Runner for python-automation-builder/plan-python-automation."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+
+REPOSITORY_DIR = Path(__file__).resolve().parents[2] / "infra" / "integrations" / "python-automation"
+sys.path.insert(0, str(REPOSITORY_DIR))
+
+from python_automation_repository import PythonAutomationError, PythonAutomationRepository  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Plan a Python automation")
+    parser.add_argument("--spec", required=True)
+    args = parser.parse_args()
+
+    try:
+        result = PythonAutomationRepository().plan_python_automation(spec_path=Path(args.spec))
+    except PythonAutomationError as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    print(json.dumps(result, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/workflow.md

@@ -0,0 +1,6 @@
+# Workflow
+
+1. Ler a spec da automacao.
+2. Validar campos obrigatorios, side effects, dependencias e sinais de segredo.
+3. Classificar idempotencia e risco.
+4. Retornar plano de artefatos sem escrever arquivos.

package/runtime/agents/python-automation-builder/capabilities/review-python-automation/capability.yaml

@@ -0,0 +1,20 @@
+id: python-automation-builder.review-python-automation
+kind: capability
+name: Review Python Automation
+version: 0.1.0
+status: draft
+purpose: Revisar automacao Python contra guardrails operacionais.
+entrypoint:
+  runner: runner.py
+  workflow: workflow.md
+  output_template: ../../templates/automation-review-report.md
+inputs:
+  required: []
+  optional:
+    - input
+    - text
+    - side-effects
+outputs:
+  artifacts:
+    - python-automation-review.json
+write_policy: read_only

package/runtime/agents/python-automation-builder/capabilities/review-python-automation/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Falhar quando faltar `--dry-run`.
+- Falhar quando side effect real nao exigir confirmacao.
+- Falhar quando houver marcador de segredo ou URL.
+- Alertar quando nao houver logging ou exit code claro.

package/runtime/agents/python-automation-builder/capabilities/review-python-automation/runner.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Runner for python-automation-builder/review-python-automation."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+
+REPOSITORY_DIR = Path(__file__).resolve().parents[2] / "infra" / "integrations" / "python-automation"
+sys.path.insert(0, str(REPOSITORY_DIR))
+
+from python_automation_repository import PythonAutomationError, PythonAutomationRepository  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Review a Python automation script")
+    parser.add_argument("--input")
+    parser.add_argument("--text")
+    parser.add_argument("--side-effects", default="updates-local")
+    args = parser.parse_args()
+
+    if not args.input and not args.text:
+        print("one of --input or --text is required", file=sys.stderr)
+        return 2
+
+    try:
+        text = Path(args.input).read_text(encoding="utf-8") if args.input else str(args.text)
+        result = PythonAutomationRepository().review_python_automation(
+            text=text,
+            side_effects=args.side_effects,
+        )
+    except (PythonAutomationError, OSError) as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    print(json.dumps(result, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/runtime/agents/python-automation-builder/capabilities/review-python-automation/workflow.md

@@ -0,0 +1,5 @@
+# Workflow
+
+1. Receber texto direto ou arquivo de script.
+2. Procurar dry-run, confirmacao, logs, redacao, exit codes e segredo.
+3. Retornar findings estruturados sem editar o arquivo.

package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/capability.yaml

@@ -0,0 +1,22 @@
+id: python-automation-builder.wrap-automation-as-capability
+kind: capability
+name: Wrap Automation As Capability
+version: 0.1.0
+status: draft
+purpose: Planejar ou escrever wrapper de capability para automacao Python aprovada.
+entrypoint:
+  runner: runner.py
+  workflow: workflow.md
+  output_template: ../../templates/capability-wrapper.md
+inputs:
+  required:
+    - spec
+    - agent-id
+    - capability-id
+  optional:
+    - execute
+    - allow-overwrite
+outputs:
+  artifacts:
+    - capability-wrapper-files.json
+write_policy: local_write

package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Wrapper nao executa a automacao gerada.
+- Escrita fica limitada ao `target_project`.
+- `agent-id` e `capability-id` devem ser kebab-case.
+- A write policy da capability embrulhada deve refletir os side effects.

package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/runner.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Runner for python-automation-builder/wrap-automation-as-capability."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+
+REPOSITORY_DIR = Path(__file__).resolve().parents[2] / "infra" / "integrations" / "python-automation"
+sys.path.insert(0, str(REPOSITORY_DIR))
+
+from python_automation_repository import PythonAutomationError, PythonAutomationRepository  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Wrap a Python automation as an Agent DevKit capability")
+    parser.add_argument("--spec", required=True)
+    parser.add_argument("--agent-id", required=True)
+    parser.add_argument("--capability-id", required=True)
+    parser.add_argument("--execute", action="store_true")
+    parser.add_argument("--allow-overwrite", action="store_true")
+    args = parser.parse_args()
+
+    try:
+        result = PythonAutomationRepository().wrap_automation_as_capability(
+            spec_path=Path(args.spec),
+            agent_id=args.agent_id,
+            capability_id=args.capability_id,
+            execute=args.execute,
+            allow_overwrite=args.allow_overwrite,
+        )
+    except PythonAutomationError as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    print(json.dumps(result, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/workflow.md

@@ -0,0 +1,6 @@
+# Workflow
+
+1. Ler e validar a spec da automacao.
+2. Exigir `target_project`, `agent-id` e `capability-id`.
+3. Planejar arquivos de capability em dry-run.
+4. Escrever apenas com `--execute` e confirmacao do runtime.