mova_agent 0.1.1

package/src/types/generated/ds.mova_episode_core_v1.d.ts

@@ -0,0 +1,56 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Core MOVA episode schema: minimal common structure for recording a meaningful step of work.
+ */
+export type DsMovaEpisodeCoreV1 = DsMovaSchemaCoreV1 & {
+  [k: string]: unknown;
+};
+
+/**
+ * Core form for MOVA data schemas (ds.*) instances: common service fields schema_id, schema_version, meta, ext.
+ */
+export interface DsMovaSchemaCoreV1 {
+  /**
+   * Canonical schema id for this data record, e.g. ds.smartlink_config_v1. Recommended but optional.
+   */
+  schema_id?: string;
+  /**
+   * Version of the schema used when this record was produced, e.g. 1 or 1.0.0.
+   */
+  schema_version?: string;
+  /**
+   * Human- and operator-oriented metadata: title, description, tags, notes. Must not contain execution instructions for LLMs.
+   */
+  meta?: {
+    /**
+     * Short human-readable title of this record.
+     */
+    title?: string;
+    /**
+     * Longer human-readable description or notes.
+     */
+    description?: string;
+    /**
+     * Optional list of tags for searching and grouping.
+     */
+    tags?: string[];
+    /**
+     * IETF language tag describing primary human language of title/description, e.g. uk, en, de.
+     */
+    lang?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Machine-oriented extensions: technical flags, computed hints, links to external systems. Must not contain LLM instructions.
+   */
+  ext?: {
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/types/generated/ds.mova_schema_core_v1.d.ts

@@ -0,0 +1,49 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Core form for MOVA data schemas (ds.*) instances: common service fields schema_id, schema_version, meta, ext.
+ */
+export interface DsMovaSchemaCoreV1 {
+  /**
+   * Canonical schema id for this data record, e.g. ds.smartlink_config_v1. Recommended but optional.
+   */
+  schema_id?: string;
+  /**
+   * Version of the schema used when this record was produced, e.g. 1 or 1.0.0.
+   */
+  schema_version?: string;
+  /**
+   * Human- and operator-oriented metadata: title, description, tags, notes. Must not contain execution instructions for LLMs.
+   */
+  meta?: {
+    /**
+     * Short human-readable title of this record.
+     */
+    title?: string;
+    /**
+     * Longer human-readable description or notes.
+     */
+    description?: string;
+    /**
+     * Optional list of tags for searching and grouping.
+     */
+    tags?: string[];
+    /**
+     * IETF language tag describing primary human language of title/description, e.g. uk, en, de.
+     */
+    lang?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Machine-oriented extensions: technical flags, computed hints, links to external systems. Must not contain LLM instructions.
+   */
+  ext?: {
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/types/generated/ds.mova_token_budget_contract_v0.d.ts

@@ -0,0 +1,140 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Contract for controlling token usage and costs in MOVA Agent
+ */
+export interface MOVATokenBudgetContractV0 {
+  /**
+   * Version of the token budget contract
+   */
+  version: string;
+  /**
+   * Predefined budget profiles for different use cases
+   */
+  profiles?: {
+    [k: string]: {
+      /**
+       * Token and resource limits
+       */
+      limits?: {
+        /**
+         * Maximum number of model calls per run
+         */
+        max_model_calls?: number;
+        /**
+         * Maximum total input tokens per run
+         */
+        max_input_tokens?: number;
+        /**
+         * Maximum total output tokens per run
+         */
+        max_output_tokens?: number;
+        /**
+         * Maximum total tokens (input + output) per run
+         */
+        max_total_tokens?: number;
+        /**
+         * Maximum output tokens per single model call
+         */
+        max_output_tokens_per_call?: number;
+        /**
+         * Maximum total cost in USD per run
+         */
+        max_total_cost_usd?: number;
+        /**
+         * Maximum number of tool calls per run
+         */
+        max_tool_calls?: number;
+        /**
+         * Maximum total bytes of tool output that goes into context
+         */
+        max_tool_output_bytes_total?: number;
+        /**
+         * Maximum stdout bytes per run
+         */
+        max_stdout_bytes?: number;
+        /**
+         * Maximum stderr bytes per run
+         */
+        max_stderr_bytes?: number;
+      };
+      /**
+       * Policy for handling budget exceedances
+       */
+      policy?: {
+        /**
+         * Action to take when budget is exceeded
+         */
+        on_budget_exceeded: 'fail' | 'warn' | 'truncate_and_continue';
+        /**
+         * Whether to fail fast on any budget violation
+         */
+        fail_fast?: boolean;
+      };
+      [k: string]: unknown;
+    };
+  };
+  /**
+   * Token and resource limits
+   */
+  limits?: {
+    /**
+     * Maximum number of model calls per run
+     */
+    max_model_calls?: number;
+    /**
+     * Maximum total input tokens per run
+     */
+    max_input_tokens?: number;
+    /**
+     * Maximum total output tokens per run
+     */
+    max_output_tokens?: number;
+    /**
+     * Maximum total tokens (input + output) per run
+     */
+    max_total_tokens?: number;
+    /**
+     * Maximum output tokens per single model call
+     */
+    max_output_tokens_per_call?: number;
+    /**
+     * Maximum total cost in USD per run
+     */
+    max_total_cost_usd?: number;
+    /**
+     * Maximum number of tool calls per run
+     */
+    max_tool_calls?: number;
+    /**
+     * Maximum total bytes of tool output that goes into context
+     */
+    max_tool_output_bytes_total?: number;
+    /**
+     * Maximum stdout bytes per run
+     */
+    max_stdout_bytes?: number;
+    /**
+     * Maximum stderr bytes per run
+     */
+    max_stderr_bytes?: number;
+  };
+  /**
+   * Policy for handling budget exceedances
+   */
+  policy?: {
+    /**
+     * Action to take when budget is exceeded
+     */
+    on_budget_exceeded: 'fail' | 'warn' | 'truncate_and_continue';
+    /**
+     * Whether to fail fast on any budget violation
+     */
+    fail_fast?: boolean;
+  };
+}

package/src/types/generated/ds.runtime_binding_core_v1.d.ts

@@ -0,0 +1,112 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Core schema describing a neutral binding between MOVA scenarios/skills and an execution runtime, without vendor-specific details.
+ */
+export type DsRuntimeBindingCoreV1 = DsMovaSchemaCoreV1 & {
+  /**
+   * Canonical id of the runtime environment, e.g. runtime_core:cloudflare_worker, runtime_core:local_process.
+   */
+  runtime_id: string;
+  /**
+   * High-level runtime kind.
+   */
+  runtime_kind: 'serverless' | 'container' | 'local_process' | 'browser' | 'edge' | 'other';
+  /**
+   * Primary implementation language or platform, e.g. nodejs, python, wasm, browser-js.
+   */
+  language?: string;
+  /**
+   * Optional version of the runtime or platform.
+   */
+  runtime_version?: string;
+  /**
+   * Optional environment profile id, e.g. dev, staging, prod.
+   */
+  env_profile_id?: string;
+  /**
+   * Targets that are bound to this runtime.
+   */
+  binding_targets?: {
+    /**
+     * What is being bound: template, scenario, skill, connector_proxy, service.
+     */
+    target_kind: 'template' | 'scenario' | 'skill' | 'connector_proxy' | 'service' | 'other';
+    /**
+     * Identifier of the bound target (e.g. npm package name, scenario id, skill id).
+     */
+    target_id: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Capability flags for this runtime binding (network, storage, secrets, etc.). This is descriptive, not executable.
+   */
+  capabilities?: {
+    /**
+     * Network access level, e.g. none, internal_only, internet_limited, internet_full.
+     */
+    network?: string;
+    /**
+     * Storage capabilities, e.g. none, key_value, sql, object_store.
+     */
+    storage?: string;
+    /**
+     * Secrets handling capabilities, e.g. none, env_only, managed_store.
+     */
+    secrets?: string;
+    /**
+     * Queueing/message capabilities if any.
+     */
+    queues?: string;
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+};
+
+/**
+ * Core form for MOVA data schemas (ds.*) instances: common service fields schema_id, schema_version, meta, ext.
+ */
+export interface DsMovaSchemaCoreV1 {
+  /**
+   * Canonical schema id for this data record, e.g. ds.smartlink_config_v1. Recommended but optional.
+   */
+  schema_id?: string;
+  /**
+   * Version of the schema used when this record was produced, e.g. 1 or 1.0.0.
+   */
+  schema_version?: string;
+  /**
+   * Human- and operator-oriented metadata: title, description, tags, notes. Must not contain execution instructions for LLMs.
+   */
+  meta?: {
+    /**
+     * Short human-readable title of this record.
+     */
+    title?: string;
+    /**
+     * Longer human-readable description or notes.
+     */
+    description?: string;
+    /**
+     * Optional list of tags for searching and grouping.
+     */
+    tags?: string[];
+    /**
+     * IETF language tag describing primary human language of title/description, e.g. uk, en, de.
+     */
+    lang?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Machine-oriented extensions: technical flags, computed hints, links to external systems. Must not contain LLM instructions.
+   */
+  ext?: {
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}

package/src/types/generated/ds.security_event_episode_core_v1.d.ts

@@ -0,0 +1,138 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Local security episode schema that covers the MOVA base episode plus security metadata.
+ */
+export type DsSecurityEventEpisodeCoreV1 = DsSecurityEventEpisodeCoreV11 & DsSecurityEventEpisodeCoreV12;
+export type DsSecurityEventEpisodeCoreV11 = {
+  [k: string]: unknown;
+};
+
+export interface DsSecurityEventEpisodeCoreV12 {
+  /**
+   * Unique identifier of this episode.
+   */
+  episode_id: string;
+  /**
+   * Logical type of the episode, e.g. a security event subtype.
+   */
+  episode_type: string;
+  /**
+   * MOVA language version used when recording this episode.
+   */
+  mova_version: string;
+  /**
+   * Timestamp when the episode record was created.
+   */
+  recorded_at: string;
+  /**
+   * Optional execution start timestamp.
+   */
+  started_at?: string;
+  /**
+   * Optional execution end timestamp.
+   */
+  finished_at?: string;
+  /**
+   * References to envelopes that served as inputs.
+   */
+  input_envelopes?: {
+    envelope_type: string;
+    envelope_id?: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * References to data records that form the context.
+   */
+  input_data_refs?: {
+    data_type: string;
+    data_id?: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Description of the executor.
+   */
+  executor: {
+    role?: string;
+    executor_id: string;
+    executor_kind?: string;
+    environment?: {
+      [k: string]: unknown;
+    };
+  };
+  result_status: 'pending' | 'in_progress' | 'completed' | 'failed' | 'partial' | 'cancelled' | 'skipped';
+  result_summary: string;
+  result_details?: {
+    [k: string]: unknown;
+  };
+  output_data_refs?: {
+    data_type: string;
+    data_id?: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Optional metadata for the episode.
+   */
+  meta_episode?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Concrete type of security event.
+   */
+  security_event_type: string;
+  /**
+   * High-level category for grouping security events.
+   */
+  security_event_category:
+    | 'auth'
+    | 'authorization'
+    | 'policy_violation'
+    | 'instruction_misuse'
+    | 'data_access'
+    | 'rate_limit'
+    | 'config'
+    | 'infrastructure'
+    | 'other';
+  /**
+   * Severity of the event from the security perspective.
+   */
+  severity: 'info' | 'low' | 'medium' | 'high' | 'critical';
+  /**
+   * Identifier of the applicable security policy profile.
+   */
+  policy_profile_id?: string;
+  /**
+   * Optional reference to the triggered policy.
+   */
+  policy_ref?: {
+    policy_document_id?: string;
+    rule_id?: string;
+    policy_version?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Version of the security model.
+   */
+  security_model_version: string;
+  detection_source?: 'human_review' | 'rule_engine' | 'runtime_guard' | 'external_system' | 'other';
+  detection_confidence?: number;
+  recommended_actions?: {
+    action_type: string;
+    reason?: string;
+    priority?: 'low' | 'medium' | 'high';
+    [k: string]: unknown;
+  }[];
+  actions_taken?: {
+    action_type: string;
+    taken_at?: string;
+    actor?: string;
+    status?: 'completed' | 'failed' | 'skipped';
+    details?: string;
+    [k: string]: unknown;
+  }[];
+}

package/src/types/generated/ds.ui_text_bundle_core_v1.d.ts

@@ -0,0 +1,118 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * This file was automatically generated by scripts/gen_types.ts.
+ * Do not edit manually. Update JSON Schemas and rerun npm run gen:types.
+ */
+
+/**
+ * Core schema for UI text bundles with strict separation between human-facing text, model instructions, and system/log text.
+ */
+export type DsUiTextBundleCoreV1 = DsMovaSchemaCoreV1 & {
+  /**
+   * Identifier of this text bundle within a template or application.
+   */
+  bundle_id: string;
+  /**
+   * Optional id of the context this bundle belongs to (e.g. envelope id, step id, screen id).
+   */
+  context_id?: string;
+  /**
+   * Logical role of this UI text in the flow.
+   */
+  role: 'question' | 'explanation' | 'hint' | 'error_message' | 'success_message' | 'section_title' | 'other';
+  /**
+   * Human-facing UI text that is shown directly to the user.
+   */
+  human_text: {
+    /**
+     * Channel id from global.text_channel_catalog_v1. Must be human_ui.
+     */
+    channel: 'human_ui';
+    /**
+     * IETF language tag for the human text, e.g. uk, de, en.
+     */
+    lang?: string;
+    /**
+     * Text shown to the human user. Must not contain direct instructions for an LLM.
+     */
+    text: string;
+  };
+  /**
+   * Optional model-only instruction text that accompanies this UI element, never shown to the user.
+   */
+  model_text?: {
+    /**
+     * Channel id from global.text_channel_catalog_v1. Must be model_instruction.
+     */
+    channel: 'model_instruction';
+    /**
+     * IETF language tag for the model text, if applicable.
+     */
+    lang?: string;
+    /**
+     * Instruction or guidance for the model on how to interpret this UI element and related data.
+     */
+    text: string;
+  };
+  /**
+   * Optional system/log text for diagnostics; never used as prompts or shown to users.
+   */
+  log_text?: {
+    /**
+     * Channel id from global.text_channel_catalog_v1. Must be system_log.
+     */
+    channel: 'system_log';
+    /**
+     * IETF language tag for the log text, if applicable.
+     */
+    lang?: string;
+    /**
+     * Technical log or diagnostic text associated with this UI context; not a prompt.
+     */
+    text: string;
+  };
+};
+
+/**
+ * Core form for MOVA data schemas (ds.*) instances: common service fields schema_id, schema_version, meta, ext.
+ */
+export interface DsMovaSchemaCoreV1 {
+  /**
+   * Canonical schema id for this data record, e.g. ds.smartlink_config_v1. Recommended but optional.
+   */
+  schema_id?: string;
+  /**
+   * Version of the schema used when this record was produced, e.g. 1 or 1.0.0.
+   */
+  schema_version?: string;
+  /**
+   * Human- and operator-oriented metadata: title, description, tags, notes. Must not contain execution instructions for LLMs.
+   */
+  meta?: {
+    /**
+     * Short human-readable title of this record.
+     */
+    title?: string;
+    /**
+     * Longer human-readable description or notes.
+     */
+    description?: string;
+    /**
+     * Optional list of tags for searching and grouping.
+     */
+    tags?: string[];
+    /**
+     * IETF language tag describing primary human language of title/description, e.g. uk, en, de.
+     */
+    lang?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Machine-oriented extensions: technical flags, computed hints, links to external systems. Must not contain LLM instructions.
+   */
+  ext?: {
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+}