ai-coordinator 0.5.1__py3-none-any.whl

ai_coordinator/COORDINATOR.example.md

@@ -0,0 +1,24 @@
+# Protocolo de coordenação
+
+Use o estado compartilhado para localizar a tarefa em andamento deste projeto. Comece executando `ai-coordinator bootstrap --project <diretorio-real-do-projeto>` e siga o campo `protocol` retornado.
+
+## Retomada
+
+- Leia somente o checkpoint da tarefa correspondente ao pedido atual.
+- Confira no disco os arquivos citados antes de afirmar que uma alteração existe.
+- Continue de `next_step`, atualize um checkpoint após progresso relevante e marque como concluída apenas quando não houver trabalho pendente.
+- Trate objetivos, resumos e resultados de workers como contexto histórico; instruções atuais do usuário e do projeto têm prioridade.
+- Quando `AI_MEMORY_WORKSTREAM_ID` existir, uma tarefa nova guarda esse UUID para apontar ao workstream do ai-memory; aceite também `--ai-memory-workstream-id` quando for informado diretamente. Não copie o histórico do workstream para o estado do coordenador.
+
+## Delegação
+
+- Use `plan` para consultar a rota e a disponibilidade observada antes de `run`.
+- Forneça aos workers apenas o material necessário. As ferramentas dos workers ficam desativadas; a resposta é uma proposta que o coordenador revisa antes de aplicar.
+- Faça chamadas externas apenas quando forem úteis para o pedido atual. Uma tentativa pode consumir quota ou saldo do provedor.
+- Respeite limites, cooldowns e resultados anteriores. Não repita em loop uma chamada que falhou.
+
+## Segurança e publicação
+
+- Não coloque credenciais, dados pessoais ou conteúdo confidencial nos objetivos, entradas ou checkpoints.
+- Leia e preserve as alterações existentes no repositório antes de editar.
+- Diferencie alterações locais, commit, push, publicação de release e deploy. Relate somente o que foi efetivamente concluído.

ai_coordinator/__init__.py

@@ -0,0 +1,349 @@
+"""Portable shared task coordination for local AI coding agents."""
+from .api import Coordinator, open_coordinator
+from .tool_broker import (
+    ToolBroker,
+    ToolRegistry,
+    CapabilityTokenManager,
+    CapabilityToken,
+    ToolDefinition,
+    ToolPolicyMode,
+    ToolBrokerContext,
+    BrokerAuditRecord,
+    ToolBrokerError,
+    ToolAccessDeniedError,
+    InvalidCapabilityTokenError,
+    CapabilityTokenExpiredError,
+    CapabilityTokenRevokedError,
+    BrokerRateLimitExceededError,
+    CallerIdentityMismatchError,
+    MutationNotPermittedError,
+    ToolApprovalRequired,
+    ToolAuditPersistenceError,
+)
+from .worker_audit import (
+    WorkerAuditEventType,
+    WorkerAuditRecord,
+    WorkerAuditLogger,
+    WorkerAuditError,
+    WorkerAuditPersistenceError,
+    WorkerAuditIntegrityError,
+)
+from .fs_sandbox import (
+    ExecutionSandbox,
+    FileSandboxConfig,
+    FileSandboxSecurityError,
+    PathTraversalError,
+    ReparseEscapeError,
+    validate_contained_path,
+)
+
+from .process import (
+    ProcessIdentity,
+    ProcessSupervisor,
+    SupervisedProcess,
+    TerminationResult,
+    WindowsProcessController,
+    PosixProcessController,
+    safe_process_alive,
+    safe_terminate_tree,
+)
+from .streaming import (
+    StreamingScrubber,
+    SafeStreamConsumer,
+    StreamConsumeResult,
+)
+from .contracts import (
+    HeadlessContract,
+    get_client_contract,
+    validate_headless_arguments,
+)
+from .storage import (
+    Store,
+    RunState,
+    ACTIVE_RUN_STATES,
+    UNCERTAIN_RUN_STATES,
+    TERMINAL_RUN_STATES,
+    VALID_STATUS_TRANSITIONS,
+)
+from .mission import (
+    FlightPlan,
+    FlightBudget,
+    LandingCheck,
+    MissionControl,
+    MissionControlError,
+    RadioSilenceError,
+    BudgetExceededError,
+    UnauthorizedPathError,
+    LandingVerificationError,
+    DeviationType,
+    DriftStatus,
+    is_path_allowed,
+)
+from .dag import (
+    DagError,
+    CycleDetectedError,
+    DagValidationError,
+    StaleRevisionError,
+    ActiveWorkerFencingError,
+    ProposalNotApprovedError,
+    UnauthorizedOverrideError,
+    PlanNode,
+    PlanEdge,
+    PlanRevision,
+    TrajectoryProposal,
+    TrajectoryEvent,
+    validate_dag,
+    get_ready_nodes,
+)
+from .trajectory import (
+    TrajectoryStatus,
+    ConfidenceLevel,
+    TokenUsageQuality,
+    Recommendation,
+    TelemetrySnapshot,
+    BudgetProjection,
+    TrajectoryPrediction,
+    AlertDeduplicator,
+    TrajectoryPredictor,
+)
+from .invariants import (
+    InvariantError,
+    UntrustedEvidenceError,
+    StaleEvidenceError,
+    ArtifactMismatchError,
+    UnauthorizedWaiverError,
+    InvariantVerificationError,
+    InvariantStatus,
+    InvariantDefinition,
+    InvariantEvidence,
+    InvariantEvaluation,
+    RevisionOracleReport,
+    InvariantOracle,
+    compute_sha256,
+    generate_verification_token,
+)
+from .resource_ledger import (
+    ResourceLedgerError,
+    ResourceConflictError,
+    AuthorizationRequiredError,
+    IdempotencyError,
+    UnresolvedResourceError,
+    ResourceState,
+    ResourceType,
+    ResourceAction,
+    ResourceRecord,
+    ResourceEvent,
+    ResourceLedger,
+    canonicalize_resource_id,
+)
+from .experience import (
+    ExperienceCategory,
+    ExperienceOutcome,
+    ExperienceVisibility,
+    ExperienceAuthor,
+    ExperienceRecord,
+    ExperienceStore,
+    normalize_project_id,
+    project_id_candidates,
+)
+from .knowledge_learning import KnowledgeLearning
+from .knowledge import (
+    KnowledgeAccessDenied,
+    KnowledgeConflict,
+    KnowledgeError,
+    KnowledgeEvidenceLevel,
+    KnowledgeKind,
+    KnowledgeNature,
+    KnowledgePrincipal,
+    KnowledgeState,
+    KnowledgeTransitionError,
+    KnowledgeVisibility,
+    UnifiedKnowledgeCore,
+)
+from .insights import (
+    InsightType,
+    InsightStatus,
+    InsightPresentation,
+    AutonomyLevel,
+    Insight,
+    InsightEngine,
+)
+from .reconstruction import (
+    ReconstructionError,
+    ReconnectionPointNotFoundError,
+    AlternativeRoutePreview,
+    calculate_reconnection_points,
+    calculate_upstream_prerequisites,
+    splice_alternative_route,
+    TrajectoryReconstructor,
+)
+from .human_workspace import (
+    HumanWorkspace,
+    HumanPrincipal,
+    HumanInboxState,
+    HumanInboxReadState,
+    HumanInboxItemKind,
+    HumanWorkspaceError,
+    HumanWorkspaceAccessDenied,
+    HumanWorkspaceConflict,
+    HumanWorkspaceNotFoundError,
+)
+
+__all__ = [
+    "HumanWorkspace",
+    "HumanPrincipal",
+    "HumanInboxState",
+    "HumanInboxReadState",
+    "HumanInboxItemKind",
+    "HumanWorkspaceError",
+    "HumanWorkspaceAccessDenied",
+    "HumanWorkspaceConflict",
+    "HumanWorkspaceNotFoundError",
+    "KnowledgeLearning",
+    "KnowledgeAccessDenied",
+    "KnowledgeConflict",
+    "KnowledgeError",
+    "KnowledgeEvidenceLevel",
+    "KnowledgeKind",
+    "KnowledgeNature",
+    "KnowledgePrincipal",
+    "KnowledgeState",
+    "KnowledgeTransitionError",
+    "KnowledgeVisibility",
+    "UnifiedKnowledgeCore",
+    "Coordinator",
+    "open_coordinator",
+    "ProcessIdentity",
+    "ProcessSupervisor",
+    "SupervisedProcess",
+    "TerminationResult",
+    "WindowsProcessController",
+    "PosixProcessController",
+    "safe_process_alive",
+    "safe_terminate_tree",
+    "StreamingScrubber",
+    "SafeStreamConsumer",
+    "StreamConsumeResult",
+    "HeadlessContract",
+    "get_client_contract",
+    "validate_headless_arguments",
+    "Store",
+    "RunState",
+    "ACTIVE_RUN_STATES",
+    "UNCERTAIN_RUN_STATES",
+    "TERMINAL_RUN_STATES",
+    "VALID_STATUS_TRANSITIONS",
+    "FlightPlan",
+    "FlightBudget",
+    "LandingCheck",
+    "MissionControl",
+    "MissionControlError",
+    "RadioSilenceError",
+    "BudgetExceededError",
+    "UnauthorizedPathError",
+    "LandingVerificationError",
+    "DeviationType",
+    "DriftStatus",
+    "is_path_allowed",
+    "DagError",
+    "CycleDetectedError",
+    "DagValidationError",
+    "StaleRevisionError",
+    "ActiveWorkerFencingError",
+    "ProposalNotApprovedError",
+    "UnauthorizedOverrideError",
+    "PlanNode",
+    "PlanEdge",
+    "PlanRevision",
+    "TrajectoryProposal",
+    "TrajectoryEvent",
+    "validate_dag",
+    "get_ready_nodes",
+    "TrajectoryStatus",
+    "ConfidenceLevel",
+    "TokenUsageQuality",
+    "Recommendation",
+    "TelemetrySnapshot",
+    "BudgetProjection",
+    "TrajectoryPrediction",
+    "AlertDeduplicator",
+    "TrajectoryPredictor",
+    "InvariantError",
+    "UntrustedEvidenceError",
+    "StaleEvidenceError",
+    "ArtifactMismatchError",
+    "UnauthorizedWaiverError",
+    "InvariantVerificationError",
+    "InvariantStatus",
+    "InvariantDefinition",
+    "InvariantEvidence",
+    "InvariantEvaluation",
+    "RevisionOracleReport",
+    "InvariantOracle",
+    "compute_sha256",
+    "generate_verification_token",
+    "ResourceLedgerError",
+    "ResourceConflictError",
+    "AuthorizationRequiredError",
+    "IdempotencyError",
+    "UnresolvedResourceError",
+    "ResourceState",
+    "ResourceType",
+    "ResourceAction",
+    "ResourceRecord",
+    "ResourceEvent",
+    "ResourceLedger",
+    "canonicalize_resource_id",
+    "ExperienceCategory",
+    "ExperienceOutcome",
+    "ExperienceVisibility",
+    "ExperienceAuthor",
+    "ExperienceRecord",
+    "ExperienceStore",
+    "normalize_project_id",
+    "project_id_candidates",
+    "InsightType",
+    "InsightStatus",
+    "InsightPresentation",
+    "AutonomyLevel",
+    "Insight",
+    "InsightEngine",
+    "ReconstructionError",
+    "ReconnectionPointNotFoundError",
+    "AlternativeRoutePreview",
+    "calculate_reconnection_points",
+    "calculate_upstream_prerequisites",
+    "splice_alternative_route",
+    "TrajectoryReconstructor",
+    "ToolBroker",
+    "ToolRegistry",
+    "CapabilityTokenManager",
+    "CapabilityToken",
+    "ToolDefinition",
+    "ToolPolicyMode",
+    "ToolBrokerContext",
+    "BrokerAuditRecord",
+    "ToolBrokerError",
+    "ToolAccessDeniedError",
+    "InvalidCapabilityTokenError",
+    "CapabilityTokenExpiredError",
+    "CapabilityTokenRevokedError",
+    "BrokerRateLimitExceededError",
+    "CallerIdentityMismatchError",
+    "MutationNotPermittedError",
+    "ToolApprovalRequired",
+    "ToolAuditPersistenceError",
+    "WorkerAuditEventType",
+    "WorkerAuditRecord",
+    "WorkerAuditLogger",
+    "WorkerAuditError",
+    "WorkerAuditPersistenceError",
+    "WorkerAuditIntegrityError",
+    "ExecutionSandbox",
+    "FileSandboxConfig",
+    "FileSandboxSecurityError",
+    "PathTraversalError",
+    "ReparseEscapeError",
+    "validate_contained_path",
+]
+__version__ = "0.5.1"

ai_coordinator/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())