mova_agent 0.1.1

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

@@ -0,0 +1,116 @@
+/* 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 neutral schema for describing a connector to an external system (API, service, data source) without vendor-locked details.
+ */
+export type DsConnectorCoreV1 = DsMovaSchemaCoreV1 & {
+  /**
+   * Canonical id of the connector, e.g. connector_core:http_generic, connector_openai:chat.
+   */
+  connector_id: string;
+  /**
+   * Provider name or domain, e.g. openai, google, anthrophic, internal.
+   */
+  provider: string;
+  /**
+   * Target resource or service name, e.g. chat, embeddings, calendar, sheets.
+   */
+  resource: string;
+  /**
+   * Underlying protocol, e.g. http, https, grpc, custom.
+   */
+  protocol: string;
+  /**
+   * Supported authentication methods for this connector.
+   */
+  auth_methods?: {
+    /**
+     * Auth type.
+     */
+    type: 'none' | 'api_key' | 'oauth2' | 'jwt' | 'basic' | 'other';
+    /**
+     * Human-readable description of how this auth method is used.
+     */
+    description?: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Optional description of rate limiting behavior for this connector.
+   */
+  rate_limits?: {
+    /**
+     * Human-readable hint, e.g. 60 rpm per API key.
+     */
+    global_limit_hint?: string;
+    /**
+     * Optional per-user/per-token hint.
+     */
+    per_user_limit_hint?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Optional description of pagination behavior.
+   */
+  pagination?: {
+    /**
+     * Pagination style, e.g. cursor, offset, token, none.
+     */
+    style?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Optional description of error shape or mapping for this connector.
+   */
+  error_contract?: {
+    [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.instruction_profile_core_v1.d.ts

@@ -0,0 +1,141 @@
+/* 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 MOVA instruction profiles: describes how instructions and guardrails apply to executors, roles and envelopes.
+ */
+export type DsInstructionProfileCoreV1 = DsMovaSchemaCoreV1 & {
+  /**
+   * Canonical id of this instruction profile, e.g. mova_security_default_v1. For security profiles, should match an id from global.security_catalog_v1.security_policy_profile[*].id.
+   */
+  profile_id: string;
+  /**
+   * Version of this instruction profile, e.g. 1.0.0.
+   */
+  profile_version?: string;
+  /**
+   * Short human-readable label for this profile.
+   */
+  label?: string;
+  /**
+   * Version of the MOVA security model this profile was authored for, e.g. 1.0.0. Should match the security_model_version from the corresponding security policy profile in global.security_catalog_v1.
+   */
+  security_model_version: string;
+  /**
+   * Lifecycle status of this profile.
+   */
+  status: 'draft' | 'active' | 'deprecated';
+  /**
+   * Scope where this instruction profile should be applied.
+   */
+  applies_to?: {
+    /**
+     * Kinds of executors this profile targets.
+     */
+    executor_kinds?: ('human' | 'ai_model' | 'service' | 'tool' | 'hybrid' | 'other')[];
+    /**
+     * Executor roles this profile applies to (e.g. agent, reviewer, router).
+     */
+    roles?: string[];
+    /**
+     * Envelope ids (env.*) this profile applies to.
+     */
+    envelope_ids?: string[];
+    /**
+     * Data type ids (ds.*) this profile applies to.
+     */
+    data_types?: string[];
+    /**
+     * Free-form tags for grouping and routing.
+     */
+    tags?: string[];
+  };
+  /**
+   * Guardrail rules describing allowed/denied behaviours. Rules describe policy; they must not contain direct execution prompts for LLMs.
+   */
+  rules?: {
+    /**
+     * Identifier of the rule within this profile.
+     */
+    rule_id: string;
+    /**
+     * Human-readable description of the rule (policy statement, not an executable prompt).
+     */
+    description?: string;
+    /**
+     * Intended effect of this rule.
+     */
+    effect: 'allow' | 'deny' | 'warn' | 'log_only' | 'transform';
+    /**
+     * What this rule applies to.
+     */
+    target?: {
+      /**
+       * Target kind, e.g. instruction, tool, endpoint, data_scope, conversation, code_exec, network.
+       */
+      kind: string;
+      /**
+       * Selector expression used by the runtime (e.g. tag, pattern or other domain-specific reference).
+       */
+      selector?: string;
+      [k: string]: unknown;
+    };
+    /**
+     * Severity if this rule is violated.
+     */
+    severity?: 'info' | 'low' | 'medium' | 'high' | 'critical';
+    /**
+     * Recommended actions when this rule is violated.
+     */
+    on_violation?: 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.mova4_core_catalog_v1.d.ts

@@ -0,0 +1,80 @@
+/* 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.
+ */
+
+/**
+ * Meta-schema for describing MOVA red-core data types, verbs, envelopes and episode types in a single catalog document (no domain-specific schemas).
+ */
+export interface MOVA411CoreCatalogMetaSchema {
+  /**
+   * Version of this MOVA core catalog document.
+   */
+  version: string;
+  /**
+   * List of MOVA data type definitions (ds.*).
+   */
+  data_types?: {
+    /**
+     * Canonical id, e.g. ds.mova_schema_core_v1
+     */
+    id: string;
+    title?: string;
+    description?: string;
+    /**
+     * URL or path to the JSON Schema implementing this data type.
+     */
+    schema_ref: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Canonical verb definitions.
+   */
+  verbs?: {
+    /**
+     * Verb id, e.g. create, update, route
+     */
+    id: string;
+    description?: string;
+  }[];
+  /**
+   * Envelope definitions (env.*).
+   */
+  envelopes?: {
+    /**
+     * Canonical id, e.g. env.mova4_core_catalog_publish_v1
+     */
+    id: string;
+    /**
+     * Referenced verb id.
+     */
+    verb: string;
+    description?: string;
+    /**
+     * Referenced data type ids used as inputs.
+     */
+    input_types?: string[];
+    /**
+     * Referenced data type ids used as outputs.
+     */
+    output_types?: string[];
+    [k: string]: unknown;
+  }[];
+  /**
+   * Episode type definitions.
+   */
+  episode_types?: {
+    /**
+     * Canonical id, e.g. ds.security_event_episode_core_v1
+     */
+    id: string;
+    description?: string;
+    /**
+     * URL or path to the JSON Schema implementing this episode type.
+     */
+    schema_ref: string;
+    [k: string]: unknown;
+  }[];
+}

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

@@ -0,0 +1,120 @@
+/* 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.
+ */
+
+/**
+ * Summary of a MOVA agent run execution
+ */
+export interface DsMovaAgentRunSummaryV1 {
+  /**
+   * Unique identifier for this run
+   */
+  run_id: string;
+  /**
+   * Identifier of the original request
+   */
+  request_id: string;
+  /**
+   * Overall execution status
+   */
+  status: 'success' | 'failure' | 'partial_success' | 'cancelled' | 'timeout';
+  /**
+   * Start time of the run
+   */
+  timestamp_start: string;
+  /**
+   * End time of the run
+   */
+  timestamp_end: string;
+  /**
+   * Number of steps executed
+   */
+  steps_executed: number;
+  /**
+   * Number of successful steps
+   */
+  steps_successful?: number;
+  /**
+   * Number of failed steps
+   */
+  steps_failed?: number;
+  /**
+   * Total duration in milliseconds
+   */
+  total_duration_ms?: number;
+  /**
+   * Brief summary of any errors that occurred
+   */
+  error_summary?: string;
+  /**
+   * Token budget contract applied to this run
+   */
+  token_budget?: {
+    /**
+     * Version of the token budget contract
+     */
+    contract_version?: string;
+    /**
+     * Policy for handling budget exceedances
+     */
+    policy?: 'fail' | 'warn' | 'truncate_and_continue';
+    /**
+     * Token and resource limits
+     */
+    limits?: {
+      max_model_calls?: number;
+      max_input_tokens?: number;
+      max_output_tokens?: number;
+      max_total_tokens?: number;
+      max_output_tokens_per_call?: number;
+      max_total_cost_usd?: number;
+      max_tool_calls?: number;
+      max_tool_output_bytes_total?: number;
+      max_stdout_bytes?: number;
+      max_stderr_bytes?: number;
+      [k: string]: unknown;
+    };
+    [k: string]: unknown;
+  };
+  /**
+   * Token usage summary for this run
+   */
+  token_usage?: {
+    total_input_tokens?: number;
+    total_output_tokens?: number;
+    total_tokens?: number;
+    total_cost_usd?: number;
+    call_count?: number;
+    usage_available?: boolean;
+    per_call_summary?: {
+      input_tokens?: number;
+      output_tokens?: number;
+      total_tokens?: number;
+      cost_usd?: number;
+      provider?: string;
+      model?: string;
+      timestamp?: string;
+      note?: string;
+      [k: string]: unknown;
+    }[];
+    [k: string]: unknown;
+  };
+  /**
+   * Overall budget compliance status
+   */
+  budget_status?: 'passed' | 'warned' | 'failed';
+  /**
+   * List of budget violations
+   */
+  budget_violations?: {
+    type?: string;
+    limit?: number | string;
+    actual?: number | string;
+    message?: string;
+    [k: string]: unknown;
+  }[];
+  [k: string]: unknown;
+}

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

@@ -0,0 +1,53 @@
+/* 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.
+ */
+
+/**
+ * A single step in a MOVA agent plan
+ */
+export interface DsMovaAgentStepV1 {
+  /**
+   * Unique identifier for this step
+   */
+  id: string;
+  /**
+   * Canonical MOVA verb type
+   */
+  verb: string;
+  /**
+   * ID of the connector to use
+   */
+  connector_id: string;
+  /**
+   * Input data for the step
+   */
+  input?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Reference to output from a prior step
+   */
+  input_from?: {
+    /**
+     * ID of the step to get input from
+     */
+    step_id?: string;
+    /**
+     * Path to extract data from the referenced step's output
+     */
+    path?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Reference to expected output schema
+   */
+  expected_output_schema_ref?: string;
+  /**
+   * Error handling strategy for this step
+   */
+  on_error?: 'fatal' | 'soft';
+  [k: string]: unknown;
+}

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

@@ -0,0 +1,152 @@
+/* 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 neutral schema for describing a connector to an external system (API, service, data source) without vendor-locked details.
+ */
+export type DsConnectorCoreV1 = DsMovaSchemaCoreV1 & {
+  /**
+   * Canonical id of the connector, e.g. connector_core:http_generic, connector_openai:chat.
+   */
+  connector_id: string;
+  /**
+   * Provider name or domain, e.g. openai, google, anthrophic, internal.
+   */
+  provider: string;
+  /**
+   * Target resource or service name, e.g. chat, embeddings, calendar, sheets.
+   */
+  resource: string;
+  /**
+   * Underlying protocol, e.g. http, https, grpc, custom.
+   */
+  protocol: string;
+  /**
+   * Supported authentication methods for this connector.
+   */
+  auth_methods?: {
+    /**
+     * Auth type.
+     */
+    type: 'none' | 'api_key' | 'oauth2' | 'jwt' | 'basic' | 'other';
+    /**
+     * Human-readable description of how this auth method is used.
+     */
+    description?: string;
+    [k: string]: unknown;
+  }[];
+  /**
+   * Optional description of rate limiting behavior for this connector.
+   */
+  rate_limits?: {
+    /**
+     * Human-readable hint, e.g. 60 rpm per API key.
+     */
+    global_limit_hint?: string;
+    /**
+     * Optional per-user/per-token hint.
+     */
+    per_user_limit_hint?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Optional description of pagination behavior.
+   */
+  pagination?: {
+    /**
+     * Pagination style, e.g. cursor, offset, token, none.
+     */
+    style?: string;
+    [k: string]: unknown;
+  };
+  /**
+   * Optional description of error shape or mapping for this connector.
+   */
+  error_contract?: {
+    [k: string]: unknown;
+  };
+  [k: string]: unknown;
+};
+
+/**
+ * Allowlist menu of tools with connector contracts and infra bindings
+ */
+export interface DsMovaAgentToolPoolV1 {
+  tools: {
+    /**
+     * Unique identifier for this tool
+     */
+    id: string;
+    connector: DsConnectorCoreV1;
+    binding: {
+      /**
+       * Type of handler to use
+       */
+      driver_kind: 'noop' | 'http' | 'restricted_shell' | 'mcp_proxy';
+      /**
+       * List of allowed destinations for this binding
+       */
+      destination_allowlist?: string[];
+      limits?: {
+        timeout_ms?: number;
+        max_data_size?: number;
+        [k: string]: unknown;
+      };
+      /**
+       * References to input/output schemas for validation
+       */
+      schema_refs?: {
+        [k: string]: unknown;
+      };
+      [k: string]: unknown;
+    };
+    [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.mova_agent_validation_report_v1.d.ts

@@ -0,0 +1,43 @@
+/* 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.
+ */
+
+/**
+ * Report of validation results for a plan or other artifact
+ */
+export interface DsMovaAgentValidationReportV1 {
+  /**
+   * Reference to the validated artifact
+   */
+  artifact_ref: string;
+  /**
+   * Time when validation was performed
+   */
+  validation_timestamp: string;
+  /**
+   * Whether the artifact passed validation
+   */
+  valid: boolean;
+  results: {
+    type: 'error' | 'warning' | 'info';
+    /**
+     * Description of the validation result
+     */
+    message: string;
+    /**
+     * JSON path to the element that generated this result
+     */
+    path?: string;
+    /**
+     * Additional context about the validation result
+     */
+    context?: {
+      [k: string]: unknown;
+    };
+    [k: string]: unknown;
+  }[];
+  [k: string]: unknown;
+}