@contractspec/example.agent-console 0.0.0-canary-20260113170453

package/dist/run/run.operation.d.ts

@@ -0,0 +1,720 @@
+import * as _contractspec_lib_contracts12 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema194 from "@contractspec/lib.schema";
+
+//#region src/run/run.operation.d.ts
+/**
+ * ExecuteAgentCommand - Starts a new agent run.
+ */
+declare const ExecuteAgentCommand: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  agentId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  input: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      message: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      context: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+  };
+  sessionId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  stream: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  maxIterations: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+  };
+  timeoutMs: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  runId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  estimatedWaitMs: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+  };
+}>, {
+  key: string;
+  version: string;
+  stability: string;
+  owners: "@agent-console-team"[];
+  tags: string[];
+  when: string;
+  payload: _contractspec_lib_schema194.SchemaModel<{
+    id: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    agentId: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    agentName: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    status: {
+      type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+      isOptional: false;
+    };
+    totalTokens: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: false;
+    };
+    durationMs: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: true;
+    };
+    estimatedCostUsd: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: true;
+    };
+    queuedAt: {
+      type: _contractspec_lib_schema194.FieldType<Date, string>;
+      isOptional: false;
+    };
+    completedAt: {
+      type: _contractspec_lib_schema194.FieldType<Date, string>;
+      isOptional: true;
+    };
+  }>;
+}[]>;
+/**
+ * CancelRunCommand - Cancels an in-progress run.
+ */
+declare const CancelRunCommand: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  runId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  success: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+}>, {
+  key: string;
+  version: string;
+  stability: string;
+  owners: "@agent-console-team"[];
+  tags: string[];
+  when: string;
+  payload: _contractspec_lib_schema194.SchemaModel<{
+    id: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    agentId: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    agentName: {
+      type: _contractspec_lib_schema194.FieldType<string, string>;
+      isOptional: false;
+    };
+    status: {
+      type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+      isOptional: false;
+    };
+    totalTokens: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: false;
+    };
+    durationMs: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: true;
+    };
+    estimatedCostUsd: {
+      type: _contractspec_lib_schema194.FieldType<number, number>;
+      isOptional: true;
+    };
+    queuedAt: {
+      type: _contractspec_lib_schema194.FieldType<Date, string>;
+      isOptional: false;
+    };
+    completedAt: {
+      type: _contractspec_lib_schema194.FieldType<Date, string>;
+      isOptional: true;
+    };
+  }>;
+}[]>;
+/**
+ * GetRunQuery - Retrieves a run by ID.
+ */
+declare const GetRunQuery: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  runId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  includeSteps: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  includeLogs: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  agentId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  userId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  sessionId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  input: {
+    type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+  output: {
+    type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  status: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  errorMessage: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  errorCode: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  totalTokens: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+    defaultValue: number;
+  };
+  promptTokens: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+    defaultValue: number;
+  };
+  completionTokens: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+    defaultValue: number;
+  };
+  totalIterations: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+    defaultValue: number;
+  };
+  durationMs: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+  };
+  estimatedCostUsd: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+  };
+  queuedAt: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: false;
+  };
+  startedAt: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: true;
+  };
+  completedAt: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  steps: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      stepNumber: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      type: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+        isOptional: false;
+      };
+      toolId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      toolName: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      input: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      output: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      status: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+      };
+      errorMessage: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      tokensUsed: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+        defaultValue: number;
+      };
+      durationMs: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: true;
+      };
+      startedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: false;
+      };
+      completedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+  logs: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      stepId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      level: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+        isOptional: false;
+      };
+      message: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      data: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      source: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      traceId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      spanId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      timestamp: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+  agent: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      name: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      modelProvider: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      modelName: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+    }>;
+    isOptional: true;
+  };
+}>, undefined>;
+/**
+ * ListRunsQuery - Lists runs for an organization or agent.
+ */
+declare const ListRunsQuery: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  organizationId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  agentId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  userId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  sessionId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+    isOptional: true;
+  };
+  startDate: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: true;
+  };
+  endDate: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: true;
+  };
+  limit: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  items: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      agentId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      agentName: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      status: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+      };
+      totalTokens: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      durationMs: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: true;
+      };
+      estimatedCostUsd: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: true;
+      };
+      queuedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: false;
+      };
+      completedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  hasMore: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * GetRunStepsQuery - Retrieves steps for a run.
+ */
+declare const GetRunStepsQuery: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  runId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  steps: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      stepNumber: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      type: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+        isOptional: false;
+      };
+      toolId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      toolName: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      input: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      output: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      status: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+      };
+      errorMessage: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      tokensUsed: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+        defaultValue: number;
+      };
+      durationMs: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: true;
+      };
+      startedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: false;
+      };
+      completedAt: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * GetRunLogsQuery - Retrieves logs for a run.
+ */
+declare const GetRunLogsQuery: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  runId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  level: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  stepId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  limit: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  items: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      stepId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      level: {
+        type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+        isOptional: false;
+      };
+      message: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      data: {
+        type: _contractspec_lib_schema194.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+      source: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      traceId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      spanId: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: true;
+      };
+      timestamp: {
+        type: _contractspec_lib_schema194.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  hasMore: {
+    type: _contractspec_lib_schema194.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * GetRunMetricsQuery - Retrieves aggregated metrics for runs.
+ */
+declare const GetRunMetricsQuery: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema194.SchemaModel<{
+  organizationId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: false;
+  };
+  agentId: {
+    type: _contractspec_lib_schema194.FieldType<string, string>;
+    isOptional: true;
+  };
+  startDate: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: false;
+  };
+  endDate: {
+    type: _contractspec_lib_schema194.FieldType<Date, string>;
+    isOptional: false;
+  };
+  granularity: {
+    type: _contractspec_lib_schema194.EnumType<[string, string, string, string]>;
+    isOptional: true;
+    defaultValue: string;
+  };
+}>, _contractspec_lib_schema194.SchemaModel<{
+  totalRuns: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  completedRuns: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  failedRuns: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  totalTokens: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  totalCostUsd: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  averageDurationMs: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  successRate: {
+    type: _contractspec_lib_schema194.FieldType<number, number>;
+    isOptional: false;
+  };
+  timeline: {
+    type: _contractspec_lib_schema194.SchemaModel<{
+      period: {
+        type: _contractspec_lib_schema194.FieldType<string, string>;
+        isOptional: false;
+      };
+      runs: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      tokens: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      costUsd: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+      avgDurationMs: {
+        type: _contractspec_lib_schema194.FieldType<number, number>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+//#endregion
+export { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, ListRunsQuery };
+//# sourceMappingURL=run.operation.d.ts.map