talos-code 0.0.1 → 0.2.0

package/vendor/harness-ui/src/runtime-build-manifest.mjs

@@ -0,0 +1,26 @@
+const MANIFEST_KEYS = ['runtimeId', 'version', 'commit', 'platform', 'sha256', 'source'];
+const HEX40 = /^[a-f0-9]{40}$/i;
+const HEX64 = /^[a-f0-9]{64}$/i;
+
+function invalid(message) {
+  const error = new Error(message);
+  error.code = 'LOCAL_RUNTIME_INVALID';
+  return error;
+}
+
+function exactKeys(value, keys) {
+  return Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
+}
+
+export function parseRuntimeBuildManifest(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value) || !exactKeys(value, MANIFEST_KEYS)) {
+    throw invalid('runtime build manifest shape is invalid');
+  }
+  for (const key of ['runtimeId', 'version', 'platform']) {
+    if (typeof value[key] !== 'string' || value[key].trim() === '') throw invalid(`${key} is required`);
+  }
+  if (typeof value.commit !== 'string' || !HEX40.test(value.commit)) throw invalid('commit must be a full hexadecimal revision');
+  if (typeof value.sha256 !== 'string' || !HEX64.test(value.sha256)) throw invalid('sha256 must be a hexadecimal digest');
+  if (typeof value.source !== 'string' || !/^https:\/\//i.test(value.source)) throw invalid('source must be an HTTPS URL');
+  return { ...value };
+}

package/vendor/harness-ui/src/runtime-contract.mjs

@@ -0,0 +1,59 @@
+import { parseRuntimeEventEnvelope as parseExistingRuntimeEventEnvelope } from './local-runtime-events.mjs';
+
+export const RUNTIME_BOOTSTRAP_SCHEMA = 'talos.harness-ui.runtime-bootstrap.v1';
+export const RUNTIME_RESOURCE_SCHEMA = 'talos.harness-ui.resource.v1';
+export const RUNTIME_PHASES = Object.freeze(['booting', 'offline', 'degraded', 'ready-empty', 'ready-active']);
+
+export class RuntimeContractError extends Error {
+  constructor(message, code = 'RUNTIME_CONTRACT_INVALID') {
+    super(message);
+    this.name = 'RuntimeContractError';
+    this.code = code;
+  }
+}
+
+function invalid(message) { throw new RuntimeContractError(message); }
+function exactKeys(value, expected) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    && Object.keys(value).length === expected.length && expected.every((key) => Object.hasOwn(value, key));
+}
+function nonEmpty(value) { return typeof value === 'string' && value.trim() !== ''; }
+function validDate(value) { return typeof value === 'string' && Number.isFinite(Date.parse(value)); }
+
+export function parseResourceEnvelope(value) {
+  const keys = ['schema', 'status', 'items', 'consulted', 'observedAt', 'reason'];
+  if (!exactKeys(value, keys) || value.schema !== RUNTIME_RESOURCE_SCHEMA) invalid('Envelope risorsa runtime non valido.');
+  if (!['available', 'unavailable'].includes(value.status)) invalid('Stato risorsa runtime non riconosciuto.');
+  if (typeof value.consulted !== 'boolean' || !validDate(value.observedAt)) invalid('Metadati risorsa runtime non validi.');
+  if (value.reason !== null && !nonEmpty(value.reason)) invalid('Motivo risorsa runtime non valido.');
+  if (value.status === 'available') {
+    if (!value.consulted || !Array.isArray(value.items)) invalid('Una risorsa disponibile deve essere stata consultata e avere un elenco.');
+  } else if (value.items !== null || value.consulted) {
+    invalid('Una risorsa non disponibile non può dichiarare elementi o consultazione completata.');
+  }
+  return structuredClone(value);
+}
+
+export function parseBootstrapEnvelope(value) {
+  const keys = ['schema', 'authoritative', 'runtime', 'observedAt'];
+  if (!exactKeys(value, keys) || value.schema !== RUNTIME_BOOTSTRAP_SCHEMA) invalid('Bootstrap runtime non valido.');
+  if (value.authoritative !== 'backend' || !validDate(value.observedAt)) invalid('Il bootstrap deve essere confermato dal backend.');
+  if (value.runtime !== null) parseResourceEnvelope(value.runtime);
+  return structuredClone(value);
+}
+
+export function deriveRuntimePhase(snapshot) {
+  if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) invalid('Snapshot runtime non valido.');
+  if (snapshot.authoritative !== 'backend') invalid('Lo stato runtime del browser non è autorevole.');
+  if (!['booting', 'offline', 'degraded', 'ready'].includes(snapshot.state)) invalid('Fase runtime non riconosciuta.');
+  if (snapshot.state === 'booting') return 'booting';
+  if (snapshot.state === 'offline') return 'offline';
+  if (snapshot.state === 'degraded') return 'degraded';
+  const runtime = parseResourceEnvelope(snapshot.runtime);
+  if (runtime.status !== 'available') return 'degraded';
+  return runtime.items.length === 0 ? 'ready-empty' : 'ready-active';
+}
+
+// Compatibilità: il trasporto degli eventi locale resta quello già usato da
+// runtime llama/OpenAI; questo modulo non lo trasforma in un modello dominio.
+export const parseRuntimeEventEnvelope = parseExistingRuntimeEventEnvelope;