@semacode/cli 2.1.0 → 2.3.0

package/dist/sistemasInterativos/autonomy.d.ts

@@ -0,0 +1,230 @@
+import { type AcceptanceLockV1 } from "./operations.js";
+export declare const SCHEMA_AUTONOMIA: "sema.interactive.autonomy/v1";
+export declare const SCHEMA_PLAYTEST_FUZZ: "sema.interactive.playtest-fuzz/v1";
+export declare const SCHEMA_AUTORIDADE_MULTIPLAYER: "sema.interactive.multiplayer-authority/v1";
+export type ModoAutonomia = "OBSERVE_ONLY" | "SUGGEST" | "SAFE_APPLY_EXTERNAL";
+export type ClasseRiscoPatch = "OBSERVATION_ONLY" | "SAFE_REVERSIBLE" | "PRIVILEGED" | "IRREVERSIBLE";
+export type DecisaoProvaAutonomia = "PASS" | "FAIL" | "INCONCLUSIVE";
+export interface PoliticaAutonomia {
+    readonly mode: ModoAutonomia;
+    readonly maxCycles: number;
+    readonly stopCriteria: readonly string[];
+    readonly allowedRiskClasses: readonly ClasseRiscoPatch[];
+    readonly requireHumanApprovalFor: readonly ClasseRiscoPatch[];
+}
+export interface DiagnosticoAutonomia {
+    readonly diagnosticId: string;
+    readonly failedInvariant: string;
+    readonly phase: string;
+    readonly evidenceIds: readonly string[];
+    readonly semanticTargetId: string;
+}
+export interface PropostaPatchAutonomia {
+    readonly patchId: string;
+    readonly diagnosticId: string;
+    readonly semanticTargetId: string;
+    readonly ownerJobId: string;
+    readonly adapterId: string;
+    readonly adapterVersion: string;
+    readonly operation: string;
+    readonly riskClass: ClasseRiscoPatch;
+    readonly mutates: boolean;
+    readonly humanApproved: boolean;
+    readonly inputDigest: string;
+    readonly mutationScope: {
+        readonly artifactDigest: string;
+        readonly sceneId: string;
+        readonly timeRange: FaixaTempoAcceptanceAutonomia;
+    };
+    readonly snapshotDigest?: string;
+    readonly checkpointDigest?: string;
+    readonly rollbackPlanDigest?: string;
+    readonly resourceLockIds: readonly string[];
+}
+export interface SimulacaoPatchAutonomia {
+    readonly simulationId: string;
+    readonly patchId: string;
+    readonly sandboxDigest: string;
+    readonly resultDigest: string;
+    readonly passed: boolean;
+    readonly evidenceDigests: readonly string[];
+}
+export interface ProvaPatchAutonomia {
+    readonly proofId: string;
+    readonly patchId: string;
+    readonly simulationId: string;
+    readonly verifierId: string;
+    readonly independentOfProducer: boolean;
+    readonly evidenceDigests: readonly string[];
+    readonly decision: DecisaoProvaAutonomia;
+}
+export interface LockAutonomia {
+    readonly lockId: string;
+    readonly resourceType: "GPU" | "EDITOR" | "CACHE";
+    readonly ownerRunId: string;
+    readonly ownerJobId: string;
+    readonly checkpointDigest: string;
+}
+export interface FaixaTempoAcceptanceAutonomia {
+    readonly start: number;
+    readonly end: number;
+    readonly unit: "FRAME" | "TICK" | "SECOND";
+}
+export interface AcceptanceLockAutonomia {
+    readonly lock: AcceptanceLockV1;
+    readonly lockDigest: string;
+    readonly invalidationEvidenceDigest?: string;
+}
+export interface AcceptanceClaimAutonomia {
+    readonly claimId: string;
+    readonly patchId: string;
+    readonly artifactDigest: string;
+    readonly sceneId: string;
+    readonly timeRange: FaixaTempoAcceptanceAutonomia;
+    readonly acceptanceLocksDigest: string;
+    readonly claimDigest: string;
+}
+export interface CicloReparoAutonomo {
+    readonly schemaVersion: typeof SCHEMA_AUTONOMIA;
+    readonly runId: string;
+    readonly cycleIndex: number;
+    readonly previousCycleDigest: "GENESIS" | string;
+    readonly triggeredStopCriteria: readonly string[];
+    readonly systemId: string;
+    readonly definitionDigest: string;
+    readonly policy: PoliticaAutonomia;
+    readonly diagnostics: readonly DiagnosticoAutonomia[];
+    readonly proposals: readonly PropostaPatchAutonomia[];
+    readonly simulations: readonly SimulacaoPatchAutonomia[];
+    readonly proofs: readonly ProvaPatchAutonomia[];
+    readonly resourceLocks: readonly LockAutonomia[];
+    readonly acceptanceLocks: readonly AcceptanceLockAutonomia[];
+    readonly acceptanceLocksDigest: string;
+    readonly acceptanceClaims: readonly AcceptanceClaimAutonomia[];
+    readonly recoveryToken: string;
+}
+export interface ResultadoCicloReparoAutonomo {
+    readonly valido: boolean;
+    readonly cycleDigest: string;
+    readonly eligibleSafePatches: readonly string[];
+    readonly blockedPatches: readonly string[];
+    readonly diagnostics: readonly {
+        readonly failedInvariant: string;
+        readonly phase: string;
+        readonly evidenceIds: readonly string[];
+        readonly likelyCauses: readonly string[];
+        readonly nextActions: readonly string[];
+    }[];
+    readonly nextActions: readonly string[];
+    readonly completed: false;
+    readonly authoritative: false;
+    readonly executed: false;
+    readonly bloqueios: readonly string[];
+}
+export interface BotPlaytest {
+    readonly botId: string;
+    readonly strategy: "EXPLORER" | "GOAL" | "ADVERSARIAL" | "REGRESSION";
+    readonly seed: number;
+    readonly maxSteps: number;
+    readonly permissions: readonly string[];
+}
+export interface AcaoInputFuzz {
+    readonly actionId: string;
+    readonly type: "BUTTON" | "AXIS" | "POINTER" | "TEXT";
+    readonly minimum: number;
+    readonly maximum: number;
+}
+export interface CheckpointPlaytest {
+    readonly checkpointId: string;
+    readonly phase: "BEFORE" | "AFTER";
+    readonly stateDigest: string;
+}
+export interface CasoSaveLoad {
+    readonly caseId: string;
+    readonly type: "NORMAL" | "CORRUPT_RECOVERY" | "VERSION_MIGRATION";
+    readonly sourceCheckpointId: string;
+    readonly targetCheckpointId: string;
+    readonly sandboxOnly: boolean;
+    readonly originalImmutable: boolean;
+}
+export interface PlanoPlaytestFuzz {
+    readonly schemaVersion: typeof SCHEMA_PLAYTEST_FUZZ;
+    readonly planId: string;
+    readonly systemId: string;
+    readonly definitionDigest: string;
+    readonly bots: readonly BotPlaytest[];
+    readonly inputActions: readonly AcaoInputFuzz[];
+    readonly stateCheckpoints: readonly CheckpointPlaytest[];
+    readonly saveLoadCases: readonly CasoSaveLoad[];
+    readonly fuzzBounds: {
+        readonly maxSteps: number;
+        readonly maxRuntimeSeconds: number;
+        readonly maxMemoryMb: number;
+        readonly maxDiskMb: number;
+        readonly maxCases: number;
+    };
+    readonly stopCriteria: readonly ("CRASH" | "HANG" | "RESOURCE_EXHAUSTION" | "INVARIANT_FAILURE")[];
+    readonly evidenceRequirements: readonly string[];
+}
+export interface ResultadoPlanoPlaytestFuzz {
+    readonly valido: boolean;
+    readonly planDigest: string;
+    readonly scenarioIds: readonly string[];
+    readonly nextActions: readonly string[];
+    readonly authoritative: false;
+    readonly executed: false;
+    readonly bloqueios: readonly string[];
+}
+export interface AutoridadeMultiplayer {
+    readonly authorityId: string;
+    readonly role: "SERVER" | "CLIENT" | "PEER";
+    readonly principalId: string;
+}
+export interface EstadoReplicadoMultiplayer {
+    readonly stateId: string;
+    readonly semanticTargetId: string;
+    readonly sensitive: boolean;
+    readonly ownerAuthorityId: string;
+    readonly writerAuthorityIds: readonly string[];
+    readonly readerAuthorityIds: readonly string[];
+    readonly frequencyHz: number;
+    readonly conflictPolicy: "SERVER_WINS" | "SEQUENCE" | "CRDT" | "LOCKSTEP" | "CONSENSUS";
+    readonly clientInputValidated: boolean;
+}
+export interface ModeloAutoridadeMultiplayer {
+    readonly schemaVersion: typeof SCHEMA_AUTORIDADE_MULTIPLAYER;
+    readonly modelId: string;
+    readonly systemId: string;
+    readonly topology: "SERVER_AUTHORITATIVE" | "CLIENT_AUTHORITATIVE" | "PEER_TO_PEER" | "HYBRID";
+    readonly authorities: readonly AutoridadeMultiplayer[];
+    readonly replicatedState: readonly EstadoReplicadoMultiplayer[];
+    readonly conflicts: readonly {
+        readonly conflictId: string;
+        readonly stateId: string;
+        readonly resolution: string;
+    }[];
+    readonly reconnect: {
+        readonly disconnectDetected: boolean;
+        readonly reconnectAllowed: boolean;
+        readonly resyncSnapshot: boolean;
+        readonly replaySinceSequence: boolean;
+        readonly timeoutMs: number;
+    };
+    readonly securityInvariants: readonly string[];
+    readonly evidenceRequirements: readonly string[];
+}
+export interface ResultadoModeloAutoridadeMultiplayer {
+    readonly valido: boolean;
+    readonly modelDigest: string;
+    readonly authorityGaps: readonly string[];
+    readonly nextActions: readonly string[];
+    readonly authoritative: false;
+    readonly executed: false;
+    readonly bloqueios: readonly string[];
+}
+export declare function tokenRecuperacaoEsperado(ciclo: Pick<CicloReparoAutonomo, "runId" | "cycleIndex" | "previousCycleDigest" | "proposals">): string;
+export declare function digestAcceptanceLocksAutonomia(locks: readonly AcceptanceLockAutonomia[]): string;
+export declare function digestAcceptanceClaimAutonomia(claim: Omit<AcceptanceClaimAutonomia, "claimDigest">): string;
+export declare function validarCicloReparoAutonomo(entrada: unknown): ResultadoCicloReparoAutonomo;
+export declare function validarPlanoPlaytestFuzz(entrada: unknown): ResultadoPlanoPlaytestFuzz;
+export declare function validarModeloAutoridadeMultiplayer(entrada: unknown): ResultadoModeloAutoridadeMultiplayer;